PEP_QUERY_COMPONENT_PERF_SET_NAME struttura (pep_x.h)
La struttura PEP_QUERY_COMPONENT_PERF_SET_NAME contiene informazioni di query su un set di valori di stato delle prestazioni (set di stato P) per un componente.
Sintassi
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;
Members
[in] DeviceHandle
Valore PEPHANDLE che identifica il dispositivo. Il PEP ha fornito questo handle in risposta a una notifica di PEP_DPM_REGISTER_DEVICE precedente.
[in] Component
Indice che identifica il componente. Questo membro è un indice nella matrice Components nella struttura PEP_DEVICE_REGISTER_V2 fornita in precedenza da PEP in risposta alla notifica di PEP_DPM_REGISTER_DEVICE per questo dispositivo. Se la matrice Components contiene elementi N, gli indici dei componenti sono compresi tra 0 e N-1.
[in] Set
Indice che identifica questo set di stato P. Se questo componente include set di stato M P, gli indici set di stato P sono compresi tra 0 e M-1. Il PEP ha specificato in precedenza il numero di set di stato P in risposta a una notifica di PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .
[in, NameSize
In input, le dimensioni, in byte, del buffer a cui punta il membro Name . Se Name è NULL, il PEP sovrascrive il valore di input di NameSize con le dimensioni del buffer necessarie per la stringa del nome.
[in] Name
Puntatore a un buffer di output. Il PEP scrive il nome dello stato P in questo buffer. Il nome viene archiviato come stringa con terminazione Null wide. Il membro Name è NULL se il framework di gestione power di Windows (PoFx) deve determinare la quantità di buffer da allocare per la stringa del nome. Se Name è diverso da NULL, il buffer deve essere sufficientemente grande per contenere l'intera stringa, incluso il carattere Null terminante.
Commenti
Questa struttura viene usata dalla notifica di PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME . I membri DeviceHandle, Component e Set della struttura contengono valori di input forniti da PoFx quando viene inviata questa notifica. Se il membro Name non è NULL, il PEP scrive una stringa nel buffer a cui punta nome. Se Name è NULL, PEP scrive le dimensioni del buffer necessarie nel membro NameSize .
Stringa che il PEP scrive nel buffer di output deve contenere un nome descrittivo per il set di stato P. Questo nome è destinato a rendere più facili le voci di log e i messaggi di diagnostica.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 10. |
| Intestazione | pep_x.h (includere Pep_x.h) |
Vedi anche
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES