PO_FX_CORE_DEVICE 結構 (pep_x.h)
PO_FX_CORE_DEVICE 結構包含核心系統資源中元件電源狀態屬性的相關信息,並提供軟體介面來管理這些元件。
語法
typedef struct _PO_FX_CORE_DEVICE {
ULONG Version;
ULONG ComponentCount;
PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK ComponentActiveConditionCallback;
PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK ComponentIdleConditionCallback;
PPO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK ComponentCriticalTransitionCallback;
PPO_FX_COMPONENT_IDLE_STATE_CALLBACK ComponentIdleStateCallback;
PVOID DeviceContext;
PO_FX_COMPONENT Components[ANYSIZE_ARRAY];
} PO_FX_CORE_DEVICE, *PPO_FX_CORE_DEVICE;
成員
Version
這個結構的版本號碼。
ComponentCount
這個結構結尾的 Components 陣列中的項目數目。 這個計數包含數位的所有元素,並同時包含第一個元素,這是這個結構的成員,以及此結構結尾之後的任何其他元素。
ComponentActiveConditionCallback
ComponentActiveConditionCallback 回呼例程的指標。 PoFx 會呼叫此例程,通知驅動程式指定的元件已完成從閑置條件轉換為使用中條件的轉換。
ComponentIdleConditionCallback
ComponentIdleConditionCallback 回呼例程的指標。 PoFx 會呼叫此例程,通知驅動程式指定的元件已完成從作用中條件轉換到閑置條件。
ComponentCriticalTransitionCallback
ComponentCriticalTransitionCallback 回呼例程的指標。 PoFx 會呼叫此例程,通知驅動程式指定的元件即將在閑置條件與作用中條件之間進行轉換。
ComponentIdleStateCallback
ComponentIdleStateCallback 回呼例程的指標。 PoFx 會呼叫此例程,以通知驅動程式對指定元件的 Fx 電源狀態進行擱置變更。
DeviceContext
PEP 定義裝置內容的指標。 PoFx 會提供這個指標做為呼叫 ComponentActiveConditionCallback、 ComponentIdleConditionCallback、 ComponentCriticalTransitionCallback 和 ComponentIdleStateCallback 例程中的第一個參數。 此內容對 PoFx 而言不透明。
Components[ANYSIZE_ARRAY]
PO_FX_COMPONENT 結構陣列中的第一個專案。 數位中的每個元素都會描述裝置中元件的電源屬性。 如果數位包含多個元素,則其他元素會緊接在 PO_FX_CORE_DEVICE 結構的結尾。 陣列中的項目數目是在 PO_FX_CORE_DEVICE 結構的 ComponentCount 成員中指定。
備註
PoFxRegisterCoreDevice 例程會使用此結構。
核心系統資源是由 Windows 硬體抽象層所管理的硬體裝置,例如定時器或中斷控制器, (HAL) 。
如需作用中條件與閑置條件之間元件轉換的詳細資訊,請參閱 元件層級電源管理。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從Windows 10 開始支援。 |
標頭 | pep_x.h (包含 Pep_x.h) |
另請參閱
ComponentActiveConditionCallback
ComponentCriticalTransitionCallback