structure PO_FX_CORE_DEVICE (pepfx.h)

Article
08/07/2023

La structure PO_FX_CORE_DEVICE contient des informations sur les attributs d’état d’alimentation des composants d’une ressource système principale et fournit une interface logicielle pour la gestion de l’alimentation de ces composants.

Syntaxe

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;

Membres

Version

Numéro de version de cette structure.

ComponentCount

Nombre d’éléments dans le tableau Composants à la fin de cette structure. Ce nombre inclut tous les éléments du tableau et inclut à la fois le premier élément, qui est membre de cette structure, et tous les éléments supplémentaires qui suivent la fin de cette structure.

ComponentActiveConditionCallback

Pointeur vers une routine de rappel ComponentActiveConditionCallback . PoFx appelle cette routine pour informer le pilote que le composant spécifié a effectué une transition de la condition inactive à la condition active.

ComponentIdleConditionCallback

Pointeur vers une routine de rappel ComponentIdleConditionCallback . PoFx appelle cette routine pour informer le pilote que le composant spécifié a effectué une transition de la condition active à la condition inactive.

ComponentCriticalTransitionCallback

Pointeur vers une routine de rappel ComponentCriticalTransitionCallback . PoFx appelle cette routine pour informer le pilote que le composant spécifié est sur le point d’effectuer une transition entre la condition d’inactivité et la condition active.

ComponentIdleStateCallback

Pointeur vers une routine de rappel ComponentIdleStateCallback . PoFx appelle cette routine pour informer le pilote d’une modification en attente de l’état d’alimentation Fx du composant spécifié.

DeviceContext

Pointeur vers un contexte d’appareil défini par PEP. PoFx fournit ce pointeur comme premier paramètre dans les appels aux routines ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallback et ComponentIdleStateCallback . Ce contexte est opaque pour PoFx.

Components[ANYSIZE_ARRAY]

Premier élément d’un tableau de structures PO_FX_COMPONENT . Chaque élément du tableau décrit les attributs d’alimentation d’un composant de l’appareil. Si le tableau contient plusieurs éléments, les éléments supplémentaires suivent immédiatement la fin de la structure PO_FX_CORE_DEVICE . Le nombre d’éléments dans le tableau est spécifié dans le membre ComponentCount de la structure PO_FX_CORE_DEVICE .

Remarques

Cette structure est utilisée par la routine PoFxRegisterCoreDevice .

Une ressource système principale est un périphérique matériel, tel qu’un minuteur ou un contrôleur d’interruption, qui est géré par la couche d’abstraction matérielle (HAL) Windows.

Pour plus d’informations sur les transitions de composant entre la condition active et la condition inactive, consultez Gestion de l’alimentation au niveau des composants.