PEP_QUERY_COMPONENT_PERF_SET_NAME struttura (pepfx.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

Vedi anche

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE