struttura PO_FX_CORE_DEVICE (pepfx.h)

Articolo
08/07/2023

La struttura PO_FX_CORE_DEVICE contiene informazioni sugli attributi dello stato di alimentazione dei componenti in una risorsa di sistema principale e fornisce un'interfaccia software per la gestione alimentazione di questi componenti.

Sintassi

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;

Members

Version

Numero di versione di questa struttura.

ComponentCount

Numero di elementi nella matrice Components alla fine di questa struttura. Questo conteggio include tutti gli elementi della matrice e include sia il primo elemento, che è un membro di questa struttura, sia tutti gli elementi aggiuntivi che seguono la fine di questa struttura.

ComponentActiveConditionCallback

Puntatore a una routine di callback ComponentActiveConditionCallback . PoFx chiama questa routine per notificare al driver che il componente specificato ha completato una transizione dalla condizione di inattività alla condizione attiva.

ComponentIdleConditionCallback

Puntatore a una routine di callback ComponentIdleConditionCallback . PoFx chiama questa routine per notificare al driver che il componente specificato ha completato una transizione dalla condizione attiva alla condizione di inattività.

ComponentCriticalTransitionCallback

Puntatore a una routine di callback ComponentCriticalTransitionCallback . PoFx chiama questa routine per notificare al driver che il componente specificato sta per eseguire una transizione tra la condizione di inattività e la condizione attiva.

ComponentIdleStateCallback

Puntatore a una routine di callback ComponentIdleStateCallback . PoFx chiama questa routine per notificare al driver una modifica in sospeso allo stato di alimentazione Fx del componente specificato.

DeviceContext

Puntatore a un contesto di dispositivo definito da PEP. PoFx fornisce questo puntatore come primo parametro nelle chiamate alle routine ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallback e ComponentIdleStateCallback . Questo contesto è opaco a PoFx.

Components[ANYSIZE_ARRAY]

Primo elemento in una matrice di strutture PO_FX_COMPONENT . Ogni elemento nella matrice descrive gli attributi di potenza di un componente nel dispositivo. Se la matrice contiene più elementi, gli elementi aggiuntivi seguono immediatamente la fine della struttura PO_FX_CORE_DEVICE . Il numero di elementi nella matrice viene specificato nel membro ComponentCount della struttura PO_FX_CORE_DEVICE .

Commenti

Questa struttura viene usata dalla routine PoFxRegisterCoreDevice .

Una risorsa di sistema principale è un dispositivo hardware, ad esempio un timer o un controller di interruzione, gestito dal livello di astrazione hardware di Windows (HAL).

Per altre informazioni sulle transizioni dei componenti tra la condizione attiva e la condizione di inattività, vedere Risparmio energia a livello di componente.