estrutura PO_FX_COMPONENT_PERF_SET (wdm.h)
A estrutura PO_FX_COMPONENT_PERF_SET representa um conjunto de estados de desempenho para um único componente dentro de um dispositivo.
Sintaxe
typedef struct _PO_FX_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PO_FX_PERF_STATE_UNIT Unit;
PO_FX_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPO_FX_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;
Membros
Name
Uma cadeia de caracteres opcional usada para descrever a propriedade de componente controlada pelo conjunto de estado de desempenho. Por exemplo, "Frequência do relógio" ou "Largura de banda de memória".
Flags
Definido como 0. Atualmente, nenhum sinalizador é definido para esse membro.
Unit
Um valor PO_FX_PERF_STATE_UNIT que especifica o tipo de unidade controlada pelo conjunto de estado de desempenho.
Type
Um valor PO_FX_PERF_STATE_TYPE que especifica o tipo de estados de desempenho no conjunto (um número discreto de estados ou uma distribuição contínua de estados entre um valor mínimo e máximo).
Discrete
Para conjuntos que representam um número discreto de estados de desempenho (ou seja, em que o membro tipo é PoFxPerfStateTypeDiscrete), essa estrutura aninhada descreve os estados.
Discrete.Count
O número de estados de desempenho no conjunto.
Discrete.States
Um ponteiro para uma matriz de PO_FX_PERF_STATE. O comprimento dessa matriz é especificado pelo membro contagem de. Cada elemento de matriz descreve um estado de energia no conjunto.
Range
Para conjuntos que representam uma distribuição contínua de estados de desempenho (ou seja, em que o membro Type é PoFxPerfStateTypeRange), essa estrutura aninhada descreve o valor mínimo e máximo do intervalo de estados de desempenho.
Range.Minimum
O valor mínimo do estado de desempenho.
Range.Maximum
O valor máximo do estado de desempenho.
Observações
Quando um driver de dispositivo chama o PoFxRegisterComponentPerfStates rotina para registrar um componente para suporte de estado de desempenho com a PoFx (estrutura de gerenciamento de energia), o driver pode fornecer uma estrutura PO_FX_COMPONENT_PERF_INFO que descreve os conjuntos de estados de desempenho compatíveis com o componente. O membro PerfStateSets da estrutura PO_FX_COMPONENT_PERF_INFO contém uma matriz de estruturas PO_FX_COMPONENT_PERF_SET que representam os estados de desempenho com suporte.
Espera-se que a maioria dos drivers defina um único conjunto de estados de desempenho por componente. Por exemplo, um driver pode definir um conjunto de estados de desempenho para controlar a frequência do relógio de um componente. No entanto, alguns drivers podem precisar definir mais de um conjunto de estado de desempenho para controlar várias dimensões de estados de desempenho para um componente. Por exemplo, um driver pode definir dois conjuntos de estados de desempenho para controlar a frequência do relógio e a largura de banda do barramento.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte a partir do Windows 10. |
| cabeçalho | wdm.h (inclua Wudfwdm.h) |