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 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

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.

A união sem nome contém o número de valores de desempenho discretos nesse conjunto de estados P ou o intervalo de valores nesse conjunto de estados P.

Requisitos

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

Confira também