WdmlibIoDisconnectInterruptEx function (iointex.h)

Article
02/22/2024

The WdmlibIoDisconnectInterruptEx function unregisters an interrupt service routine (ISR) that was registered by a previous call to the WdmlibIoConnectInterruptEx function.

Syntax

NTSTATUS WdmlibIoDisconnectInterruptEx(
  [in, out] PIO_DISCONNECT_INTERRUPT_PARAMETERS Parameters
);

Parameters

[in, out] Parameters

Pointer to an IO_DISCONNECT_INTERRUPT_PARAMETERS structure that contains the connection context for the interrupt being disconnected.

Return value

None.

Remarks

The driver should configure the device to issue interrupts only when these interrupts are connected. Failure to prevent a device from issuing interrupts when the interrupts are disconnected might cause system instability. For example, if a device shares a level-triggered interrupt line with other devices, and the device issues an interrupt request when the device's interrupts are disconnected, the other devices on the line will not acknowledge the interrupt and the interrupt will continue to fire. Before calling WdmlibIoDisconnectInterruptEx, the driver should configure the device to stop issuing interrupts. After calling WdmlibIoConnectInterruptEx, the driver should configure the device to start issuing interrupts.

Requirements

Requirement	Value
Minimum supported client	Available starting with Windows Vista. Drivers that must also work Microsoft Windows 2000, Windows XP, or Windows Server 2003 can instead link to Iointex.lib to use the routine.
Target Platform	Universal
Header	iointex.h (include Iointex.h, Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib; Iointex.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL