estrutura PEP_QUERY_CURRENT_COMPONENT_PERF_STATE (pepfx.h)

  • Artigo

A estrutura PEP_QUERY_CURRENT_COMPONENT_PERF_STATE contém informações sobre o estado P atual no conjunto de estado P especificado.

Sintaxe

typedef struct _PEP_QUERY_CURRENT_COMPONENT_PERF_STATE {
  PEPHANDLE DeviceHandle;
  ULONG     Component;
  ULONG     Set;
  union {
    ULONG     StateIndex;
    ULONGLONG StateValue;
  };
} PEP_QUERY_CURRENT_COMPONENT_PERF_STATE, *PPEP_QUERY_CURRENT_COMPONENT_PERF_STATE;

Membros

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.

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 Components contiver N elementos, os índices de componentes variam de 0 a N–1.

Set

O índice que identifica esse conjunto de estado P. Se M for o número de conjuntos de estado P para esse componente, 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 .

StateIndex

O índice do estado P atual para o conjunto de estado P especificado. Escreva nesse membro se os valores de desempenho do conjunto de estados P forem do tipo PoFxPerfStateTypeDiscrete.

StateValue

O valor do estado P atual para o conjunto de estado P especificado. Escreva nesse membro se os valores de desempenho do conjunto de estados P forem do tipo PoFxPerfStateTypeRange.

Comentários

Essa estrutura é usada pela notificação de PEP_DPM_QUERY_CURRENT_COMPONENT_PERF_STATE . Os membros DeviceHandle, Component e Set contêm valores de entrada fornecidos pela PoFx ( estrutura de gerenciamento de energia ) do Windows quando essa notificação é enviada. O membro StateIndex ou membro StateValue contém um valor de saída que o PEP grava na estrutura em resposta à notificação.

A união sem nome contém o nível de desempenho atual desse conjunto de estados P expresso como um índice em um conjunto de valores discretos ou como um valor em um intervalo. Em resposta a uma notificação de PEP_DPM_QUERY_COMPONENT_PERF_SET anterior, o PEP indicou se os valores de desempenho no conjunto de estados P são do tipo PoFxPerfStateTypeDiscrete ou PoFxPerfStateTypeRange.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte a partir do Windows 10.
Cabeçalho pepfx.h (inclua Pep_x.h)

Confira também