共用方式為


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進行喚醒。

  • 呼叫 PoFxCompleteDirectedPowerDown

  • 在系統呼叫 PO_FX_DIRECTED_POWER_UP_CALLBACK之前,請保留在 Dx 中。

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

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

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1903
標頭 wdm.h (包括 Wdm.h)

另請參閱

導向電源管理架構簡介

PO_FX_DIRECTED_POWER_UP_CALLBACK