共用方式為


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 狀態