IoReportInterruptActive function (wdm.h)

The IoReportInterruptActive routine informs the operating system that a registered interrupt service routine (ISR) is active and ready to handle interrupt requests.

Syntax

void IoReportInterruptActive(
  [in] PIO_REPORT_INTERRUPT_ACTIVE_STATE_PARAMETERS Parameters
);

Parameters

[in] Parameters

A pointer to an IO_REPORT_INTERRUPT_ACTIVE_STATE_PARAMETERS structure that contains the connection context associated with the interrupt. The caller received this context from the IoConnectInterruptEx call that registered the ISR.

Return value

None

Remarks

The IoConnectInterruptEx routine registers an ISR and connects the ISR to an interrupt or interrupts. After the ISR is registered, the driver can make the ISR active or inactive by calling the IoReportInterruptActive or IoReportInterruptInactive routine. By default, the ISR is active after the IoConnectInterruptEx call.

An ISR that is in the active state can be disconnected or made inactive. To disconnect the ISR and delete its registration, call the IoDisconnectInterruptEx routine. To make the ISR inactive without changing its registration, call IoReportInterruptInactive.

The IO_REPORT_INTERRUPT_ACTIVE_STATE_PARAMETERS structure must contain a valid connection contact obtained from an IoConnectInterruptEx call.

For more information about IoReportInterruptActive, see Making an ISR Active or Inactive.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 8.
Target Platform Universal
Header wdm.h (include Wdm.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

See also

IO_REPORT_INTERRUPT_ACTIVE_STATE_PARAMETERS

IoConnectInterruptEx

IoDisconnectInterruptEx

IoReportInterruptInactive