estrutura PEP_QUERY_COMPONENT_PERF_SET_NAME (pep_x.h)
A estrutura PEP_QUERY_COMPONENT_PERF_SET_NAME contém informações de consulta sobre um conjunto de valores de estado de desempenho (conjunto de estado P) para um componente.
Sintaxe
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;
Membros
[in] DeviceHandle
Um valor PEPHANDLE que identifica o dispositivo. O PEP forneceu esse identificador em resposta a uma notificação de PEP_DPM_REGISTER_DEVICE anterior.
[in] Component
O índice que identifica o componente. Esse membro é um índice na matriz Components na estrutura PEP_DEVICE_REGISTER_V2 que o PEP forneceu anteriormente em resposta à notificação de PEP_DPM_REGISTER_DEVICE para este dispositivo. Se a matriz Componentes contiver N elementos, os índices de componentes variam de 0 a N-1.
[in] Set
O índice que identifica esse conjunto de estado P. Se esse componente tiver conjuntos de estado P, os índices de conjunto de estado P variam de 0 a M a 1. O PEP especificou anteriormente o número de conjuntos de estado P em resposta a uma notificação de PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .
[in, NameSize
Na entrada, o tamanho, em bytes, do buffer apontado pelo membro Name . Se Name for NULL, o PEP substituirá o valor de entrada de NameSize pelo tamanho do buffer necessário para a cadeia de caracteres de nome.
[in] Name
Um ponteiro para um buffer de saída. O PEP grava o nome do estado P nesse buffer. O nome é armazenado como uma cadeia de caracteres largos e terminada em nulo. O membro Name será NULL se a PoFx (estrutura de gerenciamento de energia) do Windows precisar determinar o tamanho de um buffer a ser alocado para a cadeia de caracteres de nome. Se Name não for NULL, o buffer deverá ser grande o suficiente para conter toda a cadeia de caracteres, incluindo o caractere nulo de terminação.
Comentários
Essa estrutura é usada pela notificação de PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME . Os membros DeviceHandle, Component e Set da estrutura contêm valores de entrada fornecidos pelo PoFx quando essa notificação é enviada. Se o membro Name não for NULL, o PEP gravará uma cadeia de caracteres no buffer apontado por Name. Se Name for NULL, PEP gravará o tamanho do buffer necessário no membro NameSize .
A cadeia de caracteres que o PEP grava no buffer de saída deve conter um nome descritivo para o conjunto de estado P. Esse nome destina-se a tornar as entradas de log e mensagens de diagnóstico mais fáceis de entender.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte começando com Windows 10. |
| Cabeçalho | pep_x.h (inclua Pep_x.h) |
Confira também
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES