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 componentes na estrutura de PEP_DEVICE_REGISTER_V2 fornecida anteriormente pelo PEP em resposta à notificação de PEP_DPM_REGISTER_DEVICE deste 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 nome do. Se Name for NULL, o PEP substituirá o valor de entrada de NameSize com o 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 largo, 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 Nome 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.
Observações
Essa estrutura é usada pela notificação de PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME. Os membros DeviceHandle, Componente Set membros da estrutura contêm valores de entrada fornecidos pela PoFx quando essa notificação é enviada. Se o Name membro 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 do.
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 as mensagens de diagnóstico mais fáceis de entender.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 10. |
| cabeçalho | pep_x.h (inclua Pep_x.h) |
Consulte também
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES