PO_FX_DEVICE_V2 結構 (wdm.h)

發行項
02/27/2024

PO_FX_DEVICE結構描述裝置對電源管理架構的電源屬性， (PoFx) 。

語法

typedef struct _PO_FX_DEVICE_V2 {
  ULONG                                      Version;
  ULONGLONG                                  Flags;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK   ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK       ComponentIdleStateCallback;
  PPO_FX_DEVICE_POWER_REQUIRED_CALLBACK      DevicePowerRequiredCallback;
  PPO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK  DevicePowerNotRequiredCallback;
  PPO_FX_POWER_CONTROL_CALLBACK              PowerControlCallback;
  PVOID                                      DeviceContext;
  ULONG                                      ComponentCount;
  PO_FX_COMPONENT_V2                         Components[ANYSIZE_ARRAY];
} PO_FX_DEVICE_V2, *PPO_FX_DEVICE_V2;

成員

Version

這個結構的版本號碼。如果驅動程式會向 PoFx 註冊效能狀態支援，請將此成員設定為 PO_FX_VERSION_V2。否則，請將此成員設定為 PO_FX_VERSION_V1。

Flags

設定為 0。目前沒有為此成員定義旗標。

ComponentActiveConditionCallback

ComponentActiveConditionCallback 回呼例程的指標，由設備驅動器實作。

ComponentIdleConditionCallback

ComponentIdleConditionCallback 回呼例程的指標，由設備驅動器實作。

ComponentIdleStateCallback

ComponentIdleStateCallback 回呼例程的指標，由設備驅動器實作。

DevicePowerRequiredCallback

DevicePowerRequiredCallback 回呼例程的指標，由設備驅動器實作。

DevicePowerNotRequiredCallback

DevicePowerNotRequiredCallback 回呼例程的指標，由設備驅動器實作。

PowerControlCallback

設備驅動器所實作之 PowerControlCallback 回呼例程的指標。

DeviceContext

呼叫端配置裝置內容的指標。這個指標會當做參數傳遞至這個結構所指向的每個驅動程序實作回呼函式。設備驅動器會使用此內容來儲存裝置目前電源狀態的相關信息。此內容對 PoFx 而言不透明。

ComponentCount

Components 陣列中的項目數目。此外，此成員會指定裝置中的元件數目。

Components[ANYSIZE_ARRAY]

這個成員是一或多個 PO_FX_COMPONENT 元素數位的第一個專案。如果陣列包含多個元素，其他元素會緊接在 PO_FX_DEVICE 結構後面。數位包含裝置中每個元件的一個專案。每個元件的 Fx 電源狀態可以獨立控制裝置中其他元件的 Fx 電源狀態。 ANYSIZE_ARRAY常數定義為 Ntdef.h 頭檔中的 1。

備註

若要向PoFx註冊裝置，驅動程式會呼叫 PoFxRegisterDevice 例程，並提供參數作為描述裝置 之PO_FX_DEVICE 結構的指標。

Components 陣列中的每個元素都會描述裝置中一個元件的電源狀態屬性。裝置中的每個元件都會由其 Components 陣列索引來識別。 PoFxActivateComponent 和 PoFxCompleteIdleCondition 等例程會使用元件的數組索引來識別元件。

實作所有六個回呼例程不需要設備驅動器。如果驅動程式未實作對應的回呼例程，驅動程式可以在 PO_FX_DEVICE 結構中將函式指標設定為 NULL。不過，必須實作某些回呼例程。具體而言，如果裝置中的一或多個元件具有一個以上的 Fx 狀態，驅動程式必須實作 ComponentIdleStateCallback、 ComponentActiveConditionCallback 和 ComponentIdleConditionCallback 例程。否則，裝置註冊會失敗，而 PoFxRegisterDevice 會 傳回STATUS_INVALID_PARAMETER。