estrutura PEP_COMPONENT_PERF_SET (pepfx.h)

  • Artigo

A estrutura PEP_COMPONENT_PERF_SET descreve os estados de desempenho (estados P) em um conjunto de estados 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 essa cadeia de caracteres não estiver disponível para esse estado P, o membro Name será definido como NULL. Caso contrário, esse membro contém um ponteiro para uma estrutura UNICODE_STRING que contém a cadeia de caracteres.

Flags

Defina como zero. Nenhum bit de sinalizador está definido para esse membro no momento.

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 PEP_PERF_STATE_TYPE valor de enumeração 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 estado 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 esse conjunto de estado P.

Discrete.Count

O número de estados P neste conjunto de estados 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 estados P. O membro Count especifica o número de elementos nessa matriz. Um estado P é identificado por seu índice de matriz. Se a matriz contiver N elementos, os índices de estado P variam de 0 a N-1.

Range

O intervalo de valores de medida de desempenho discretos para esse conjunto de estado P.

Range.Minimum

O valor mínimo no intervalo. Esse valor é expresso nas unidades indicadas pelo membro unitário .

Range.Maximum

O valor máximo no intervalo. Esse valor é expresso nas unidades indicadas pelo membro unitário .

Comentários

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 PEP_COMPONENT_PERF_SET contêm valores de entrada fornecidos pela PoFx ( 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
Cliente mínimo com suporte Com suporte começando com Windows 10.
Cabeçalho pepfx.h (inclua Pep_x.h)

Confira também