struttura PEP_QUERY_COMPONENT_PERF_SET_NAME (pepfx.h)
La struttura PEP_QUERY_COMPONENT_PERF_SET_NAME contiene informazioni sulle query relative a un set di valori dello 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;
Membri
[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 componenti 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 N elementi, gli indici dei componenti sono compresi tra 0 e N-1.
[in] Set
Indice che identifica questo set di stati P. Se questo componente ha set di stati P M, gli indici del 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 caso di input, le dimensioni, in byte, del buffer a cui punta il Nome membro. Se Name è NULL, 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 a caratteri wide. Il membro Nome è NULL se il framework di risparmio energia di Windows (PoFx) deve determinare la dimensione di un buffer da allocare per la stringa del nome. Se Nome è diverso da NULL, il buffer deve essere sufficientemente grande da contenere l'intera stringa, incluso il carattere Null di terminazione.
Osservazioni
Questa struttura viene utilizzata dalla notifica di PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME. Il DeviceHandle, Componente Set membri della struttura contengono valori di input forniti da PoFx quando questa notifica viene inviata. Se il membro Name è diverso da NULL, pep scrive una stringa nel buffer a cui punta Name. Se Name è NULL, PEP scrive le dimensioni del buffer necessarie nel membro NameSize.
La stringa che il PEP scrive nel buffer di output deve contenere un nome descrittivo per il set di stati P. Questo nome consente di semplificare la comprensione delle voci di log e dei messaggi di diagnostica.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 10. |
| intestazione | pepfx.h (include Pep_x.h) |
Vedere anche
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES