IoReportInterruptInactive function (wdm.h)

The IoReportInterruptInactive routine informs the operating system that a registered interrupt service routine (ISR) is inactive and is not expecting interrupt requests.

Syntax

void IoReportInterruptInactive(
  [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 inactive state can be disconnected or made active. To disconnect the ISR and delete its registration, call the IoDisconnectInterruptEx routine. To make the ISR active without changing its registration, call IoReportInterruptActive.

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

For more information about IoReportInterruptInactive, 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

IoReportInterruptActive