Creates an interrupt thread that wakes up when its hardware interrupt occurs. This function does everything that RtAttachInterruptVector can do, plus specifies a hardware interrupt handler and defines interrupt sharing.

HANDLE RtAttachInterruptVectorEx(
    PSECURITY_ATTRIBUTES        pThreadAttributes,
    ULONG                       StackSize,
    BOOLEAN (RTFCNDCL * pRoutineIST)(PVOID ContextIST),
    PVOID                       ContextIST,
    ULONG                       Priority,
    INTERFACE_TYPE              InterfaceType,
    ULONG                       BusNumber,
    ULONG                       BusInterruptLevel,
    ULONG                       BusInterruptVector,
    BOOLEAN                     ShareVector,
    KINTERRUPT_MODE             InterruptMode,
    INTERRUPT_DISPOSITION (RTFCNDCL *
                                pRoutineISR)(PVOID ContextISR)
);

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 both handlers.

Priority

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.

ShareVector

Specifies whether the caller is prepared to share the interrupt level.

InterruptMode

Ignored.

pRoutineISR

Pointer to a handler called in interrupt context that allows only a small subset of functions, or NULL if no such handler is required. The handler receives the ContextIST parameter and returns one of these values:

PassToNextDevice

The associated device did not generate the interrupt (but another device sharing the interrupt level may have done);

CallInterruptThread

The pRoutineIST handler must be called;

Dismiss

No further action is required for this handler.

Remarks

• StackSize is ceiled up to a multiple of 4K bytes.
• BusInterruptLevel defines the hardware interrupt.
• The thread's priority obeys the RTX translation rules and does not have any interrupt-disabling side effect.
• The function pointed to by pRoutineISR is called from the hardware interrupt handler and may only use the RtReadPortXxx and RtWritePortXxx functions; when it returns CallInterruptThread (2), the interrupt thread is wakes. The function pointed to by pRoutineIST is called from the interrupt thread and executes in a normal iwin32 context.
• If a shared interrupt occurs, each handler is called for every interrupt, regardless of what the function pRoutineISR points to returns.
• If a non-shared interrupt occurs, it is disabled from the acceptance of the hardware signal until the function pointed to by pRoutineIST returns.