WdfInterruptGetInfo 函式 (wdfinterrupt.h)
[適用於 KMDF 和 UMDF]
WdfInterruptGetInfo 方法會擷取指定中斷的相關信息。
語法
void WdfInterruptGetInfo(
[in] WDFINTERRUPT Interrupt,
[in, out] PWDF_INTERRUPT_INFO Info
);
參數
[in] Interrupt
中斷物件的句柄。
[in, out] Info
呼叫端配置的 WDF_INTERRUPT_INFO 結構的指標,該結構已透過呼叫 WDF_INTERRUPT_INFO_INIT來初始化。
傳回值
無
備註
如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。
WdfInterruptGetInfo 方法只有在驅動程式呼叫驅動程式的 EvtDevicePrepareHardware 回呼函式之後,以及在架構呼叫驅動程式的 EvtDeviceReleaseHardware 回呼函式之前,才能取得中斷資訊。
在 WdfInterruptGetInfo 傳回之後,驅動程式可以檢查 WDF_INTERRUPT_INFO 結構的 Irql 成員來識別被動層級中斷物件。 對於被動層級中斷物件,此值PASSIVE_LEVEL。
如需驅動程式回呼函式呼叫順序的相關信息,請參閱 PnP 和電源管理案例。
如需在架構型驅動程式中處理中斷的詳細資訊,請參閱 處理硬體中斷。
範例
下列程式代碼範例會初始化 WDF_INTERRUPT_INFO 結構,並呼叫 WdfInterruptGetInfo。
WDF_INTERRUPT_INFO Info;
WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
Interrupt,
&Info
);
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最小 KMDF 版本 | 1.0 |
最低UMDF版本 | 2.0 |
標頭 | wdfinterrupt.h (包含 Wdf.h) |
程式庫 | Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF) |
IRQL | <=DISPATCH_LEVEL |
DDI 合規性規則 | DriverCreate (kmdf) |