INTERRUPT_FUNCTION_TABLE

The INTERRUPT_FUNCTION_TABLE (formally _INTERRUPT_FUNCTION_TABLE) is a table of function pointers that allow the HAL to work mostly with an abstracted notion of interrupt controllers. Its known use is as the FunctionTable member of a REGISTERED_INTERRUPT_CONTROLLER.

Documentation Status

The INTERRUPT_FUNCTION_TABLE is not documented. Neither is Microsoft known to have ever published a C-language definition in any Windows Driver Kit (WDK).

The practical equivalent of a C-language definition is available as type information in public symbol files for the HAL, starting with Windows 8. The merging of the HAL into the kernel for the 2004 release of 64-bit Windows moves this type information into the public symbols for the kernel.

Variability

The INTERRUPT_FUNCTION_TABLE is evidently intended as private to the HAL or at least between the HAL and its extension DLLs (not that any way has yet been looked for how, or even whether, these may get involved). If nothing else, this shows in the lack of any formal indicator of version or layout. It happens that the table has changed, but so far only by appending:

Incidentally, or not, the expansion for Version 1703 moved the C-language definition between headers: from ntsoc.h to intdefs.h. Whether the latter is a new header or just a renaming is not known. One disappears from the public symbols to have its place taken by the new, but both contribute the same types, with a change in line numbers, of course, but with only one change of order.

Layout

The sizes in the preceding table and the offsets and definitions in the next are from type information in public symbols as noted above for Windows 8 and higher. Whether the structure even exists in earlier versions is left for another time.

NTSTATUS 
(*InitializeLocalUnit) (
    PVOID, 
    ULONG, 
    ULONG, 
    ULONG, 
    ULONG, 
    ULONG *;

NTSTATUS 
(*InitializeIoUnit) (
    PVOID);

VOID 
(*SetPriority) (
    PVOID, 
    ULONG);

ULONG 
(*GetLocalUnitError) (
    PVOID);

VOID 
(*ClearLocalUnitError) (
    PVOID);

NTSTATUS 
(*GetLogicalId) (
    PVOID, 
    INTERRUPT_TARGET *);

NTSTATUS 
(*SetLogicalId) (
    PVOID, 
    INTERRUPT_TARGET *);

INTERRUPT_RESULT 
(*AcceptAndGetSource) (
    PVOID, 
    LONG *, 
    ULONG *);

VOID 
(*EndOfInterrupt) (
    PVOID);

VOID 
(*FastEndOfInterrupt) (
    VOID);

NTSTATUS 
(*SetLineState) (
    PVOID, 
    INTERRUPT_LINE *, 
    INTERRUPT_LINE_STATE *);

NTSTATUS 
(*RequestInterrupt) (
    PVOID, 
    INTERRUPT_LINE *, 
    INTERRUPT_TARGET *, 
    ULONG, 
    INTERRUPT_LINE *);

NTSTATUS 
(*StartProcessor) (
    PVOID, 
    ULONG, 
    PVOID, 
    ULONG);

NTSTATUS 
(*GenerateMessage) (
    PVOID, 
    INTERRUPT_LINE_STATE *, 
    ULONGLONG *, 
    ULONGLONG *;

NTSTATUS 
(*ConvertId) (
    PVOID, 
    ULONG *, 
    INTERRUPT_TARGET *, 
    UCHAR);

NTSTATUS 
(*SaveLocalInterrupts) (
    PVOID, 
    PVOID);

NTSTATUS 
(*ReplayLocalInterrupts) (
    PVOID, 
    PVOID);

NTSTATUS 
(*DeinitializeLocalUnit) (
    PVOID);

NTSTATUS 
(*DeinitializeIoUnit) (
    PVOID);

INTERRUPT_RESULT 
(*QueryAndGetSource) (
    PVOID, 
    LONG *, 
    ULONG *, 
    UCHAR *);

VOID 
(*DeactivateInterrupt) (
    PVOID, 
    ULONG);

VOID 
(*DirectedEndOfInterrupt) (
    PVOID, 
    ULONG, 
    ULONG);

NTSTATUS 
(*QueryLocalUnitInfo) (
    VOID, 
    ULONG, 
    ULONG, 
    ULONG *, 
    KINTERRUPT_MODE *, 
    KINTERRUPT_MODE *);