Partilhar via

estrutura PEP_QUERY_COMPONENT_PERF_SET (pepfx.h)

  • Artigo

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 componentes na estrutura de PEP_DEVICE_REGISTER_V2 fornecida anteriormente pelo PEP em resposta à notificação de PEP_DPM_REGISTER_DEVICE deste dispositivo. Se a matriz Componentes 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, 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.

Flags

Um conjunto de sinalizadores de entrada. Nenhum bit de sinalizador está definido atualmente para esse membro, que é sempre zero.

Unit

Um valor de enumeração PEP_PERF_STATE_UNIT 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 valor de enumeração PEP_PERF_STATE_TYPE que indica se os valores de desempenho para esse conjunto de estado 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 estado P.

Range

Use essa estrutura se Type == PepPerfStateTypeRange.

Range.Minimum

O valor mínimo no intervalo de valores de desempenho para este conjunto de estado P. Esse valor é expresso nas unidades de medida indicadas pelo membro da Unidade .

Range.Maximum

O valor máximo no intervalo de valores de desempenho para este conjunto de estado P. Esse valor é expresso nas unidades de medida indicadas pelo membro da Unidade .

Observações

Essa estrutura é usada pela notificação de PEP_DPM_QUERY_COMPONENT_PERF_SET. Os DeviceHandle, Component, Sete Flags membros contêm valores de entrada fornecidos pela PoFx (estrutura de gerenciamento de energia) do Windows quando essa notificação é enviada. O membro discrete ou membro Range 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úmero de valores de desempenho discretos neste conjunto de estado P ou o intervalo de valores neste conjunto de estado P.

Requisitos

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

Consulte também