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