EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED回呼函式 (wdfdevice.h)

  • 發行項

[適用於 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。

在架構呼叫驅動程式的 EvtInterruptDisabletDisabled 回呼函式之前，會在 IRQL = PASSIVE_LEVEL呼叫 EvtDeviceD0ExitPreInterruptsDisable 回呼函式之前呼叫。 如果驅動程式必須在停用中斷之前執行裝置特定作業，則驅動程式可以提供此函式，如果這些作業不應該在 EvtInterruptDisable 回呼函式的 IRQL = DIRQL 上執行。

如需架構何時呼叫此回呼函式的詳細資訊，請參閱 PnP 和電源管理案例。

如需處理中斷的詳細資訊，請參閱 處理硬體中斷。

規格需求

需求 值
目標平台 Universal
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfdevice.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL (请参阅一节)

另請參閱

EvtDeviceD0EntryPostInterruptsEnabled