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

Defina como 0. Atualmente, nenhum sinalizador é definido para esse membro.

Unit

Um valor PO_FX_PERF_STATE_UNIT que especifica o tipo de unidade controlado 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 Type é 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 Count . Cada elemento de matriz descreve um estado de energia no conjunto.

Range

Para conjuntos que representam uma distribuição contínua dos estados de desempenho (ou seja, onde 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.

Comentários

Quando um driver de dispositivo chama a rotina PoFxRegisterComponentPerfStates para registrar um componente para o 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 dos estados de desempenho compatíveis com o componente. O membro PerfStateSets da estrutura PO_FX_COMPONENT_PERF_INFO contém uma matriz de estruturas de 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 estado de desempenho definido para controlar várias dimensões dos estados de desempenho de 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
Cliente mínimo com suporte	Com suporte começando com Windows 10.
Cabeçalho	wdm.h (inclua Wudfwdm.h)

Confira também

Gerenciamento de Estado de Desempenho do Dispositivo

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates