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) |