[適用於 KMDF 和 UMDF]
驅動程式的 EvtDeviceD0ExitPreInterruptsDisabled 事件回呼函式會執行驅動程式停用裝置硬體中斷之前所需的裝置特定作業。
語法
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;
NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
[in] WDFDEVICE Device,
[in] WDF_POWER_DEVICE_STATE TargetState
)
{...}
參數
[in] Device
架構裝置物件的句柄。
[in] TargetState
WDF_POWER_DEVICE_STATE型別列舉值,識別裝置即將進入的裝置電源狀態。
傳回值
如果 EvtDeviceD0ExitPreInterruptsDisabled 回呼函式沒有發生任何錯誤,它必須傳回STATUS_SUCCESS或另一個狀態值,NT_SUCCESS狀態) 等於 TRUE。 否則,它必須傳回狀態值,NT_SUCCESS狀態)等於 FALSE。
如需此回呼函式傳回值的詳細資訊,請參閱 報告裝置失敗。
言論
若要註冊 EvtDeviceD0ExitPreInterruptsDisabled 回呼函式,驅動程式必須呼叫 WdfDeviceInitSetPnpPowerEventCallbacks。
EvtDeviceD0ExitPreInterruptsDisabled 回呼函式會在 IRQL = PASSIVE_LEVEL 呼叫,然後架構呼叫驅動程式的 EvtInterruptDisable 回呼函式。 如果驅動程式必須在停用中斷之前執行裝置特定作業,則驅動程式可以提供此函式,如果這些作業不應該在 EvtInterruptDisable 回呼函式的 IRQL = DIRQL 上執行。
如需架構呼叫此回呼函式時的詳細資訊,請參閱 PnP 和 Power Management Scenarios。
如需處理中斷的詳細資訊,請參閱 處理硬體中斷。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
標頭 | wdfdevice.h (包括 Wdf.h) |
IRQL | PASSIVE_LEVEL (請參閱一節) |