INtime SDK Help
RtAttachInterruptVectorEx (iwin32)
INtime SDK v6 > About INtime > Alternate APIs > iwin32 API > iwin32 API > RtAttachInterruptVectorEx (iwin32)

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

Return Values

Handle for the interrupt object
Success.
NULL
Failure.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/iwin32.h iwin32.h iwin32.lib

Note

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

See Also

RtReleasehInterruptVector, RtAttachInterruptVector, Thread priorities, iwin32 API, iwin32 Overview