estructura PEP_COMPONENT_PERF_SET (pepfx.h)

  • Artículo

La estructura de PEP_COMPONENT_PERF_SET describe los estados de rendimiento (P-states) en un conjunto de estados P.

Sintaxis

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;

Miembros

Name

Cadena opcional que describe la propiedad del dispositivo controlada por este conjunto de estados P. Por ejemplo, esta cadena puede ser "Frecuencia del reloj" o "Ancho de banda de memoria". Si no hay ninguna cadena disponible para este estado P, el miembro Name se establece en NULL. De lo contrario, este miembro contiene un puntero a una estructura UNICODE_STRING que contiene la cadena.

Flags

Establecer en cero. Actualmente no hay bits de marca definidos para este miembro.

Unit

Estructura PEP_PERF_STATE_UNIT que especifica las unidades en las que se expresan los valores de rendimiento de este conjunto de estados P. El rendimiento de los componentes se puede expresar en hercios (frecuencia) o en bits por segundo (ancho de banda).

Type

Valor de enumeración PEP_PERF_STATE_TYPE que indica el tipo de información de rendimiento que se especifica para este componente. Este miembro indica si los valores de rendimiento de este conjunto de estados P se especifican como una lista de valores discretos o como un intervalo continuo de valores.

Discrete

Lista de valores de rendimiento discretos para este conjunto de estados P.

Discrete.Count

Número de estados P en este conjunto de estados P.

Discrete.States

Puntero a una matriz de estructuras de PEP_PERF_STATE , cada una de las cuales describe un valor de rendimiento discreto en este conjunto de estados P. El miembro Count especifica el número de elementos de esta matriz. Un estado P se identifica mediante su índice de matriz. Si la matriz contiene N elementos, los índices de estado P van de 0 a N-1.

Range

Intervalo de valores discretos de medición de rendimiento para este conjunto de estados P.

Range.Minimum

Valor mínimo del intervalo. Este valor se expresa en las unidades indicadas por el miembro Unit .

Range.Maximum

Valor máximo del intervalo. Este valor se expresa en las unidades indicadas por el miembro Unit .

Comentarios

La unión sin nombre contiene los valores de medición de rendimiento de este estado P. Esta unión contiene una lista de valores discretos (si Type == PepPerfStateTypeDiscrete) o un intervalo continuo de valores (si Type == PepPerfStateTypeRange).

El miembro PerfStateSets del PEP_COMPONENT_PERF_INFO es el primer elemento de una matriz de estructuras PEP_COMPONENT_PERF_SET . Todos los miembros de la estructura de PEP_COMPONENT_PERF_SET contienen valores de entrada proporcionados por el marco de administración de energía de Windows (PoFx). El complemento de extensión de plataforma (PEP) no debe escribir en esta estructura.

Los controladores de dispositivo usan la estructura PO_FX_COMPONENT_PERF_SET , que es similar a la estructura de PEP_COMPONENT_PERF_SET .

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Encabezado pepfx.h (include Pep_x.h)

Consulte también