WdfInterruptWdmGetInterrupt method

[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

Interrupt [in]

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

Minimum KMDF version

1.0

Header

Wdfinterrupt.h (include Wdf.h)

Library

Wdf01000.sys (see Framework Library Versioning.)

IRQL

<= DIRQL

DDI compliance rules

DriverCreate

See also

KINTERRUPT

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft