estrutura PEP_QUERY_COMPONENT_PERF_SET (pep_x.h)
A estrutura PEP_QUERY_COMPONENT_PERF_SET 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 {
PEPHANDLE DeviceHandle;
ULONG Component;
ULONG Set;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;
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 esse componente tiver conjuntos de estado P M, os índices de conjunto de estado P variam de 0 a M–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 .
Flags
Um conjunto de sinalizadores de entrada. Nenhum bit de sinalizador está definido atualmente para esse membro, que é sempre zero.
Unit
Um PEP_PERF_STATE_UNIT valor de enumeração que indica se os valores desse conjunto de estado P são expressos em hertz (unidades de frequência) ou bits por segundo (unidades de largura de banda).
Type
Um PEP_PERF_STATE_TYPE valor de enumeração que indica se os valores de desempenho para esse conjunto de estados P são expressos como uma lista de valores discretos ou como um intervalo contínuo de valores.
Discrete
Use essa estrutura se Type == PepPerfStateTypeDiscrete.
Discrete.Count
O número de valores de desempenho discretos neste conjunto de estados P.
Range
Use essa estrutura se Type == PepPerfStateTypeRange.
Range.Minimum
O valor mínimo no intervalo de valores de desempenho para esse conjunto de estado P. Esse valor é expresso nas unidades de medida indicadas pelo membro Unidade .
Range.Maximum
O valor máximo no intervalo de valores de desempenho para esse conjunto de estados P. Esse valor é expresso nas unidades de medida indicadas pelo membro Unidade .
Comentários
A união sem nome representa o número de valores de desempenho discretos nesse conjunto de estados P ou o intervalo de valores nesse conjunto de estados P.
Essa estrutura é usada pela notificação PEP_DPM_QUERY_COMPONENT_PERF_SET . Os membros DeviceHandle, Component, Set e Flags contêm valores de entrada fornecidos pela PoFx ( estrutura de gerenciamento de energia ) do Windows quando essa notificação é enviada. O membro Discrete ou o membro Range contém um valor de saída que o PEP grava na estrutura em resposta à notificação.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Com suporte a partir do Windows 10. |
| Cabeçalho | pep_x.h (inclua Pep_x.h) |