structure PEP_QUERY_COMPONENT_PERF_SET_NAME (pepfx.h)

  • Article

La structure PEP_QUERY_COMPONENT_PERF_SET_NAME contient des informations de requête sur un ensemble de valeurs d’état de performances (ensemble d’état P) pour un composant.

Syntaxe

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

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 ce composant a des jeux d’état M P, les index de jeu d’état P vont 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, NameSize

En entrée, la taille, en octets, de la mémoire tampon pointée par le membre Name . Si Name a la valeur NULL, le PEP remplace la valeur d’entrée de NameSize par la taille de mémoire tampon requise pour la chaîne de nom.

[in] Name

Pointeur vers une mémoire tampon de sortie. Le PEP écrit le nom de l’état P dans cette mémoire tampon. Le nom est stocké sous la forme d’une chaîne à caractères larges et terminée par null. Le membre Name a la valeur NULL si l’infrastructure de gestion de l’alimentation Windows (PoFx) doit déterminer la taille d’une mémoire tampon à allouer pour la chaîne de nom. Si Name n’a pas la valeur NULL, la mémoire tampon doit être suffisamment grande pour contenir la chaîne entière, y compris le caractère null de fin.

Remarques

Cette structure est utilisée par la notification PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME . Les membres DeviceHandle, Component et Set de la structure contiennent des valeurs d’entrée fournies par PoFx lors de l’envoi de cette notification. Si le membre Name n’a pas la valeur NULL, le PEP écrit une chaîne dans la mémoire tampon pointée par Nom. Si Name a la valeur NULL, PEP écrit la taille de mémoire tampon requise dans le membre NameSize .

La chaîne que le PEP écrit dans la mémoire tampon de sortie doit contenir un nom descriptif pour le jeu d’état P. Ce nom est destiné à faciliter la compréhension des entrées de journal et des messages de diagnostic.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge à partir de Windows 10.
En-tête pepfx.h (include Pep_x.h)

Voir aussi

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE