RtQueryProcessorVectorFreeCount

RtQueryProcessorVectorFreeCount queries the number of RTSS processor vectors (IDT vectors) currently available for attaching interrupts.

NOTE: RtQueryProcessorVectorFreeCount is only supported in the RTSS environment. It cannot be called from a Windows application linked to RTX64.

Syntax

ULONG RtQueryProcessorVectorFreeCount(
    ULONG ProcessorVectorFreeCount[],
);

Parameters

ProcessorVectorFreeCount

A pointer to a user-allocated array with MAXIMUM_PROCESSORS number of ULONG elements. The i-th element in the returning array represents the number of free vectors (IDT vectors) on the i-th RTSS processor.

Return Value

Returns the total number of free vectors on all RTSS processors.

Remarks

We recommend calling RtQueryProcessorVectorFreeCount to query the number of RTSS processor free vectors before calling RtAttachInterrupt with AttachVersion as ATTACH_MESSAGE_BASED_MULTI_VECTOR.

See the MultiVectorI350 sample for an example use of the RtQueryProcessorVectorFreeCount function.

Requirements

Minimum Supported Version	RTX64 3.3
Header	RtssApi.h
Library	Rtx_Rtss.lib