WdfInterruptWdmGetInterrupt function (wdfinterrupt.h)

[Applies to KMDF only]

The WdfInterruptWdmGetInterrupt method returns a pointer to the WDM interrupt object that is associated with a specified framework interrupt object.

Syntax

PKINTERRUPT WdfInterruptWdmGetInterrupt(
  [in] WDFINTERRUPT Interrupt
);

Parameters

[in] Interrupt

A handle to a framework interrupt object.

Return value

The WdfInterruptWdmGetInterrupt method returns a pointer to a KINTERRUPT structure. This method returns NULL if it is called before the driver's EvtInterruptEnable callback function is called or after the driver's EvtInterruptDisable callback function returns.

A bug check occurs if the driver supplies an invalid object handle.

Remarks

The pointer that the WdfInterruptWdmGetInterrupt method returns is valid until the driver's EvtInterruptDisable callback function returns.

For more information about handling interrupts in framework-based drivers, see Handling Hardware Interrupts.

Examples

The following code example obtains a pointer to the KINTERRUPT structure that is associated with a specified framework interrupt object.

PKINTERRUPT  wdmInterrupt;

wdmInterrupt = WdfInterruptWdmGetInterrupt(Interrupt);

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Header wdfinterrupt.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL <= DIRQL
DDI compliance rules DriverCreate(kmdf)

See also

KINTERRUPT