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 分鐘,預設為 2 分鐘) ,而不會執行任何啟動程式代理軟體活動。
叫用此回呼時,驅動程式通常會執行下列高階工作:
停止處理新的工作。
立即轉換成低電源狀態。
在系統呼叫驅動程式 的PO_FX_DIRECTED_POWER_UP_CALLBACK之前,保持低電源狀態。
實作步驟和順序可能會有所不同,但可能包含下列部分:
要求 Dx IRP。
Dx IRP 抵達之後,封鎖 I/O 佇列。
等候進行中的作業完成。
如果這些作業花費太長的時間,可以選擇性地取消這些作業。
執行將裝置轉換成 Dx (所需的動作,例如儲存硬體狀態) 。
視需要進行喚醒的 Arm。
維持在 Dx 中,直到系統呼叫 PO_FX_DIRECTED_POWER_UP_CALLBACK為止。
合約與 S3/S4 非常類似,但未涉及 S-IRP。
如果涉及裝置階層,導向電源架構會要求子裝置在父裝置之前關閉電源。 針對指定的父裝置,系統會考慮父系) 和間接子系所列舉的直接子系 (子系。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1903) |
標頭 | wdm.h (包含 Wdm.h) |