Creates an interrupt thread that wakes up when its hardware interrupt occurs.

HANDLE RtAttachInterruptVector(
    PSECURITY_ATTRIBUTES        pThreadAttributes,
    ULONG                       StackSize,
    VOID (RTFCNDCL *            pRoutineIST)(PVOID ContextIST),
    PVOID                       ContextIST,
    ULONG                       Priority,
    INTERFACE_TYPE              InterfaceType,
    ULONG                       BusNumber,
    ULONG                       BusInterruptLevel,
    ULONG                       BusInterruptVector
);

Parameters

pThreadAttributes

Ignored.

StackSize

The number of bytes to allocate to the new thread's stack.

pRoutineIST

Pointer to the handler to run. This handler runs in a normal thread context.

ContextIST

Parameter passed to the handler.

Priority

The thread priority for the handler routine, specified as a value between 0 (lowest priority) and 127 (highest priority).

InterfaceType

Ignored.

BusNumber

Ignored.

BusInterruptLevel

An integer that defines the hardware interrupt.

BusInterruptVector

Ignored.

Remarks

• StackSize is rounded up to a multiple of 4K bytes.
• BusInterruptLevel defines the hardware interrupt and must be between 0 and the highest interrupt in the hardware configuration.
• The thread's priority obeys the RTX translation rules and does not have any interrupt-disabling side effect.
• The function pointed to by pRoutineIST is called from the interrupt thread and executes in a normal iwin32 context.
• When an interrupt occurs, it is disabled from the acceptance of the hardware signal until the function pointed to by pRoutineIST returns.

Return Values

Handle for the interrupt object

Success.

NULL

Failure.

Requirements

Note

This function operates in the real-time portion of your application.

See Also

RtReleasehInterruptVector, RtAttachInterruptVectorEx, Thread priorities, iwin32 API, iwin32 Overview