PO_FX_DIRECTED_POWER_DOWN_CALLBACK回呼函式 (wdm.h)
用戶端驅動程式會實作PO_FX_DIRECTED_POWER_DOWN_CALLBACK回呼函式,以代表 DFx 處理驅動程式特定的關閉活動(導向 PoFx)。
語法
PO_FX_DIRECTED_POWER_DOWN_CALLBACK PoFxDirectedPowerDownCallback;
void PoFxDirectedPowerDownCallback(
PVOID Context,
ULONG Flags
)
{...}
參數
Context
提供傳入至 PoFxRegisterDevice 之內容的指標,。
Flags
保留供日後使用。
傳回值
沒有
言論
向 PoFx 註冊以進行運行時間閒置電源管理支援的 WDM 驅動程式,必須實作此回呼以新增 DFx 支援。
設定 PO_FX_DEVICE_V3 結構的適當成員,然後呼叫 PoFxRegisterDevice,以註冊此回呼函式的實作。
此回呼會在新式待命會話期間叫用,而此裝置或此裝置的相依專案已封鎖 DRIPS 專案至少兩分鐘(驅動程式可設定的逾時,預設為 2 分鐘),而不會執行任何啟動器代理的軟體活動。
叫用此回呼時,驅動程式通常會執行下列高階工作:
停止處理新工作。
立即轉換為低功率狀態。
保持低功率狀態,直到系統呼叫驅動程式的 PO_FX_DIRECTED_POWER_UP_CALLBACK為止。
實作步驟和順序可能會有所不同,但可能包含下列部分:
要求 Dx IRP。
Dx IRP 送達之後,封鎖 I/O 佇列。
等候進行中的作業完成。
如果這些作業花費的時間太長,可以選擇性地取消這些作業。
執行將裝置轉換成 Dx 所需的動作(例如儲存硬體狀態)。
視需要使用Arm進行喚醒。
在系統呼叫 PO_FX_DIRECTED_POWER_UP_CALLBACK之前,請保留在 Dx 中。
合約與 S3/S4 非常類似,但未涉及 S-IRP。
如果涉及裝置階層,導向電源架構會要求子裝置在父裝置之前關閉電源。 針對指定的父裝置,會考慮 權力關係所造成的直接子系(父系列舉的子系)和間接子系。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1903 |
標頭 | wdm.h (包括 Wdm.h) |