EVT_HIDSPICX_NOTIFY_POWERDOWN回呼函式 (hidspicx.h)
EvtHidspicxNotifyPowerdown 回呼函式是由用戶端驅動程序實作，以在裝置即將轉換為低電源狀態時接收通知。
語法
EVT_HIDSPICX_NOTIFY_POWERDOWN EvtHidspicxNotifyPowerdown;
NTSTATUS EvtHidspicxNotifyPowerdown(
WDFDEVICE Device,
BOOLEAN ArmForWake
)
{...}
參數
Device
用戶端驅動程式從先前呼叫 WdfDeviceCreate 取得的架構裝置物件的句柄。
ArmForWake
布爾值，指出裝置是否會處於即將轉換電源的目標狀態喚醒。
傳回值
NTSTATUS ，指出電源轉換的準備是否成功。 此方法不預期會在運行時間失敗，而且可能會導致 HidSpiCx 裝置失敗。
備註
用戶端驅動程式預期會實作並提供回呼，HidSpiCx 將用來通知用戶端即將關閉電源。 此回呼的目的是允許類別延伸模組指示用戶端停止處理裝置中斷，因為裝置即將進入低電源狀態。 除非發生用戶端的 D0Entry WDF 回呼，否則客戶端不應該繼續處理中斷。
此函式的目的是在進入睡眠狀態時避免在類別延伸模組將命令傳送 SET_POWER SLEEP 至裝置時發生睡眠狀態，而裝置會在類別延伸模組和用戶端驅動程式完成 Dx IRP 之前判斷提示中斷以喚醒。 如果沒有額外的回呼指示用戶端停止硬體處理中斷，硬體會發出 SPI 讀取來回應喚醒中斷，這會違反通訊協定，要求主機先傳送 SET_POWER ON 命令，再處理裝置中斷。
此函式將由被動 IRQL 的類別延伸模組呼叫，而且用戶端在中斷處理停止之前不應傳回。
無論裝置是否會在總線層級進行喚醒，都提供給用戶端方便，允許用戶端驅動程式避免在不是總線驅動程式時監視 WAIT_WAKE 命令。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 11 |
| 標頭 | hidspicx.h |
| IRQL | PASSIVE_LEVEL |