PO_FX_CORE_DEVICE-Struktur (pepfx.h)

Artikel
02/29/2024

Die PO_FX_CORE_DEVICE-Struktur enthält Informationen zu den Energiezustandsattributen der Komponenten in einer Kernsystemressource und stellt eine Softwareschnittstelle für die Energieverwaltung dieser Komponenten bereit.

Syntax

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;

Member

Version

Die Versionsnummer dieser Struktur.

ComponentCount

Die Anzahl der Elemente im Array Components am Ende dieser Struktur. Diese Anzahl umfasst alle Elemente des Arrays und umfasst sowohl das erste Element, das mitglied dieser Struktur ist, als auch alle zusätzlichen Elemente, die dem Ende dieser Struktur folgen.

ComponentActiveConditionCallback

Ein Zeiger auf eine ComponentActiveConditionCallback-Rückrufroutine . PoFx ruft diese Routine auf, um den Treiber darüber zu benachrichtigen, dass die angegebene Komponente einen Übergang von der Leerlaufbedingung zur aktiven Bedingung abgeschlossen hat.

ComponentIdleConditionCallback

Ein Zeiger auf eine ComponentIdleConditionCallback-Rückrufroutine . PoFx ruft diese Routine auf, um den Treiber darüber zu benachrichtigen, dass die angegebene Komponente einen Übergang von der aktiven Bedingung zur Leerlaufbedingung abgeschlossen hat.

ComponentCriticalTransitionCallback

Ein Zeiger auf eine ComponentCriticalTransitionCallback-Rückrufroutine . PoFx ruft diese Routine auf, um den Treiber darüber zu informieren, dass die angegebene Komponente einen Übergang zwischen der Leerlaufbedingung und der aktiven Bedingung vornehmen wird.

ComponentIdleStateCallback

Ein Zeiger auf eine ComponentIdleStateCallback-Rückrufroutine . PoFx ruft diese Routine auf, um den Treiber über eine ausstehende Änderung des F x-Energiezustands der angegebenen Komponente zu benachrichtigen.

DeviceContext

Ein Zeiger auf einen von PEP definierten Gerätekontext. PoFx stellt diesen Zeiger als ersten Parameter in Aufrufen der Routinen ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallback und ComponentIdleStateCallback bereit. Dieser Kontext ist für PoFx undurchsichtig.

Components[ANYSIZE_ARRAY]

Das erste Element in einem Array von PO_FX_COMPONENT Strukturen. Jedes Element im Array beschreibt die Leistungsattribute einer Komponente im Gerät. Wenn das Array mehr als ein Element enthält, folgen die zusätzlichen Elemente unmittelbar dem Ende der PO_FX_CORE_DEVICE Struktur. Die Anzahl der Elemente im Array wird im ComponentCount-Member der PO_FX_CORE_DEVICE-Struktur angegeben.

Hinweise

Diese Struktur wird von der PoFxRegisterCoreDevice-Routine verwendet.

Eine Kernsystemressource ist ein Hardwaregerät, z. B. ein Timer oder ein Interruptcontroller, das von der Windows-Hardwareabstraktionsebene (HAL) verwaltet wird.

Weitere Informationen zu Komponentenübergängen zwischen der aktiven Bedingung und der Leerlaufbedingung finden Sie unter Energieverwaltung auf Komponentenebene.