estrutura PEP_COMPONENT_PERF_SET (pep_x.h)
A estrutura PEP_COMPONENT_PERF_SET descreve os estados de desempenho (P-states) em um conjunto de estado P.
Sintaxe
typedef struct _PEP_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPEP_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;
Membros
Name
Uma cadeia de caracteres opcional que descreve a propriedade do dispositivo controlada por esse conjunto de estado P. Por exemplo, essa cadeia de caracteres pode ser "Frequência do relógio" ou "Largura de banda de memória". Se nenhuma cadeia de caracteres estiver disponível para esse estado P, o Name membro será definido como NULL. Caso contrário, esse membro contém um ponteiro para uma estrutura de UNICODE_STRING que contém a cadeia de caracteres.
Flags
Definido como zero. No momento, nenhum bit de sinalizador é definido para esse membro.
Unit
Uma estrutura PEP_PERF_STATE_UNIT que especifica as unidades nas quais os valores de desempenho para esse conjunto de estado P são expressos. O desempenho do componente pode ser expresso em hertz (frequência) ou em bits por segundo (largura de banda).
Type
Um valor de enumeração PEP_PERF_STATE_TYPE que indica o tipo de informações de desempenho especificadas para esse componente. Esse membro indica se os valores de desempenho para esse conjunto de estados P são especificados como uma lista de valores discretos ou como um intervalo contínuo de valores.
Discrete
A lista de valores de desempenho discretos para este conjunto de estado P.
Discrete.Count
O número de estados P neste conjunto de estado P.
Discrete.States
Um ponteiro para uma matriz de estruturas de PEP_PERF_STATE, cada uma das quais descreve um valor de desempenho discreto neste conjunto de estado P. O membro Count especifica o número de elementos nessa matriz. Um estado P é identificado pelo índice de matriz. Se a matriz contiver N elementos, os índices de estado P variam de 0 a N a 1.
Range
O intervalo de valores de medida de desempenho discretos para este conjunto de estado P.
Range.Minimum
O valor mínimo no intervalo. Esse valor é expresso nas unidades indicadas pelo membro da Unidade.
Range.Maximum
O valor máximo no intervalo. Esse valor é expresso nas unidades indicadas pelo membro da Unidade.
Observações
A união sem nome contém os valores de medida de desempenho para esse estado P. Essa união contém uma lista de valores discretos (se Type == PepPerfStateTypeDiscrete) ou um intervalo contínuo de valores (se Type == PepPerfStateTypeRange).
O membro PerfStateSets do PEP_COMPONENT_PERF_INFO é o primeiro elemento em uma matriz de estruturas PEP_COMPONENT_PERF_SET. Todos os membros da estrutura de PEP_COMPONENT_PERF_SET contêm valores de entrada fornecidos pelo (PoFx) da estrutura de gerenciamento de energia do Windows. O PEP (plug-in de extensão de plataforma) não deve gravar nessa estrutura.
Os drivers de dispositivo usam a estrutura PO_FX_COMPONENT_PERF_SET, que é semelhante à estrutura PEP_COMPONENT_PERF_SET.
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) |