estrutura PEP_QUERY_COMPONENT_PERF_SET_NAME (pepfx.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	pepfx.h (inclua Pep_x.h)

Confira também

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE