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

另請參閱

裝置電源狀態

裝置 Low-Power 狀態