struttura PO_FX_CORE_DEVICE (pepfx.h)

Articolo
02/07/2025

La struttura PO_FX_CORE_DEVICE contiene informazioni sugli attributi di stato di alimentazione dei componenti in una risorsa di sistema principale e fornisce un'interfaccia software per la gestione 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;

Membri

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 gli eventuali elementi aggiuntivi che seguono la fine di questa struttura.

ComponentActiveConditionCallback

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

ComponentIdleConditionCallback

Puntatore a un ComponentIdleConditionCallback routine di callback. 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 un ComponentCriticalTransitionCallback routine di callback. 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 un ComponentIdleStateCallback routine di callback. PoFx chiama questa routine per notificare al driver una modifica in sospeso alF x stato di alimentazione del componente specificato.

DeviceContext

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

Components[ANYSIZE_ARRAY]

Primo elemento in una matrice di strutture PO_FX_COMPONENT. Ogni elemento nella matrice descrive gli attributi di alimentazione di un componente nel dispositivo. Se la matrice contiene più di un elemento, 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.

Osservazioni

Questa struttura viene usata dalla routine poFxRegisterCoreDevice.

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

Per altre informazioni sulle transizioni dei componenti tra la condizione attiva e la condizione di inattività, vedere Component-Level Risparmio energia.