WdfInterruptGetInfo method

[Applies to KMDF and UMDF]

The WdfInterruptGetInfo method retrieves information about a specified interrupt.

Syntax


VOID WdfInterruptGetInfo(
  [in]   WDFINTERRUPT Interrupt,
  [out]  PWDF_INTERRUPT_INFO Info
);

Parameters

Interrupt [in]

A handle to the interrupt object.

Info [out]

A pointer to a caller-allocated WDF_INTERRUPT_INFO structure that has been initialized by calling WDF_INTERRUPT_INFO_INIT.

Return value

None.

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

Remarks

The WdfInterruptGetInfo method can obtain interrupt information only if your driver calls it after the framework has called the driver's EvtDevicePrepareHardware callback function and before the framework has called the driver's EvtDeviceReleaseHardware callback function.

After WdfInterruptGetInfo has returned, the driver can identify passive level interrupt objects by examining the Irql member of the WDF_INTERRUPT_INFO structure. For passive level interrupt objects, this value is PASSIVE_LEVEL.

For information about the order in which a driver's callback functions are called, see PnP and Power Management Scenarios.

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

Examples

The following code example initializes a WDF_INTERRUPT_INFO structure and calls WdfInterruptGetInfo.


WDF_INTERRUPT_INFO  Info;

WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
                    Interrupt,
                    &Info
                    );

Requirements

Minimum KMDF version

1.0

Minimum UMDF version

2.0

Header

Wdfinterrupt.h (include Wdf.h)

Library

Wdf01000.sys (KMDF);
WUDFx02000.dll (UMDF)

IRQL

<=DISPATCH_LEVEL

DDI compliance rules

DriverCreate

See also

WDF_INTERRUPT_INFO
WDF_INTERRUPT_INFO_INIT
EvtDevicePrepareHardware
EvtDeviceReleaseHardware

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft