共用方式為


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 分鐘) ,而不會執行任何啟動程式代理軟體活動。

叫用此回呼時,驅動程式通常會執行下列高階工作:

實作步驟和順序可能會有所不同,但可能包含下列部分:

  • 要求 Dx IRP。

  • Dx IRP 抵達之後,封鎖 I/O 佇列。

  • 等候進行中的作業完成。

  • 如果這些作業花費太長的時間,可以選擇性地取消這些作業。

  • 執行將裝置轉換成 Dx (所需的動作,例如儲存硬體狀態) 。

  • 視需要進行喚醒的 Arm。

  • 呼叫 PoFxCompleteDirectedPowerDown

  • 維持在 Dx 中,直到系統呼叫 PO_FX_DIRECTED_POWER_UP_CALLBACK為止。

合約與 S3/S4 非常類似,但未涉及 S-IRP。

如果涉及裝置階層,導向電源架構會要求子裝置在父裝置之前關閉電源。 針對指定的父裝置,系統會考慮父系) 和間接子系所列舉的直接子系 (子系。

規格需求

需求
最低支援的用戶端 Windows 10 (版本 1903)
標頭 wdm.h (包含 Wdm.h)

另請參閱

導向電源管理架構簡介

PO_FX_DIRECTED_POWER_UP_CALLBACK