structure PEP_QUERY_COMPONENT_PERF_STATES (pep_x.h)

Article
08/07/2023

La structure PEP_QUERY_COMPONENT_PERF_STATES contient une liste de valeurs d’état des performances discrètes (état P) pour le jeu d’état P spécifié.

Syntaxe

typedef struct _PEP_QUERY_COMPONENT_PERF_STATES {
  [in] PEPHANDLE       DeviceHandle;
  [in] ULONG           Component;
  [in] ULONG           Set;
  [in] PPEP_PERF_STATE States;
} PEP_QUERY_COMPONENT_PERF_STATES, *PPEP_QUERY_COMPONENT_PERF_STATES;

Membres

[in] DeviceHandle

Valeur PEPHANDLE qui identifie l’appareil. Le PEP a fourni ce handle en réponse à une notification PEP_DPM_REGISTER_DEVICE précédente.

[in] Component

Index qui identifie le composant. Ce membre est un index dans le tableau Composants de la structure PEP_DEVICE_REGISTER_V2 que le PEP a fourni précédemment en réponse à la notification PEP_DPM_REGISTER_DEVICE pour cet appareil. Si le tableau Composants contient N éléments, les index des composants vont de 0 à N–1.

[in] Set

Index qui identifie ce jeu d’état P. Si M est le nombre d’ensembles d’états P pour ce composant, les index de jeux d’état P varient de 0 à M-1. Le PEP a précédemment spécifié le nombre de jeux d’état P en réponse à une notification PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .

[in] States

Pointeur vers une mémoire tampon de sortie. Le PEP écrit un tableau de structures PEP_PERF_STATE dans cette mémoire tampon. Chaque élément de tableau décrit un état P dans le jeu d’état P spécifié par le membre Set . L’infrastructure de gestion de l’alimentation Windows (PoFx) a alloué cette mémoire tampon, qui est garantie d’être suffisamment grande pour contenir un tableau de la longueur que le PEP a précédemment écrit au membre Discrete.Count de la structure PEP_QUERY_COMPONENT_PERF_SET en réponse à une notification PEP_DPM_QUERY_COMPONENT_PERF_SET.

Remarques

Cette structure est utilisée par la notification PEP_DPM_QUERY_COMPONENT_PERF_STATES . Les quatre membres de cette structure contiennent des valeurs d’entrée fournies par PoFx lors de l’envoi de cette notification.