PEP_QUERY_COMPONENT_PERF_SET_NAME structure (pep_x.h)
La structure PEP_QUERY_COMPONENT_PERF_SET_NAME contient des informations de requête sur un ensemble de valeurs d’état de performances (jeu 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 Components de la structure PEP_DEVICE_REGISTER_V2 que le PEP a précédemment fournie en réponse à la notification PEP_DPM_REGISTER_DEVICE pour cet appareil. Si le tableau Components contient N éléments, les index de composant vont de 0 à N–1.
[in] Set
Index qui identifie ce jeu d’états P. Si ce composant a des jeux d’état MP, les index de jeu d’états 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
Lors de l’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 à 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’est pas 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’états 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 | pep_x.h (include Pep_x.h) |
Voir aussi
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES