estructura PO_FX_COMPONENT_PERF_SET (wdm.h)

La estructura PO_FX_COMPONENT_PERF_SET representa un conjunto de estados de rendimiento para un único componente dentro de un dispositivo.

Sintaxis

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;

Miembros

Name

Cadena de caracteres opcional que se usa para describir la propiedad de componente controlada por el conjunto de estados de rendimiento. Por ejemplo, "Frecuencia del reloj" o "Ancho de banda de memoria".

Flags

Establecer en 0. Actualmente, no se definen marcas para este miembro.

Unit

Valor PO_FX_PERF_STATE_UNIT que especifica el tipo de unidad controlada por el conjunto de estados de rendimiento.

Type

Valor de PO_FX_PERF_STATE_TYPE que especifica el tipo de estados de rendimiento del conjunto (un número discreto de estados o una distribución continua de estados entre un valor mínimo y máximo).

Discrete

Para conjuntos que representan un número discreto de estados de rendimiento (es decir, donde el miembro Type es PoFxPerfStateTypeDiscrete), esta estructura anidada describe los estados.

Discrete.Count

Número de estados de rendimiento del conjunto.

Discrete.States

Puntero a una matriz de PO_FX_PERF_STATE . El miembro Count especifica la longitud de esta matriz. Cada elemento de matriz describe un estado de alimentación del conjunto.

Range

Para los conjuntos que representan una distribución continua de estados de rendimiento (es decir, donde el miembro Type es PoFxPerfStateTypeRange), esta estructura anidada describe el valor mínimo y máximo del intervalo de estados de rendimiento.

Range.Minimum

Valor de estado de rendimiento mínimo.

Range.Maximum

Valor de estado de rendimiento máximo.

Comentarios

Cuando un controlador de dispositivo llama a la rutina PoFxRegisterComponentPerfStates para registrar un componente para admitir el estado de rendimiento con el marco de administración de energía (PoFx), el controlador puede proporcionar una estructura de PO_FX_COMPONENT_PERF_INFO que describe los conjuntos de estados de rendimiento admitidos por el componente. El miembro PerfStateSets de la estructura PO_FX_COMPONENT_PERF_INFO contiene una matriz de estructuras de PO_FX_COMPONENT_PERF_SET que representan los estados de rendimiento admitidos.

Se espera que la mayoría de los controladores definan un único conjunto de estados de rendimiento por componente. Por ejemplo, un controlador podría definir un conjunto de estados de rendimiento para controlar la frecuencia del reloj de un componente. Sin embargo, es posible que algunos controladores necesiten definir más de un estado de rendimiento establecido para controlar varias dimensiones de estados de rendimiento para un componente. Por ejemplo, un controlador podría definir dos conjuntos de estados de rendimiento para controlar la frecuencia del reloj y el ancho de banda del bus.

Requisitos

Requisito	Value
Cliente mínimo compatible	Se admite a partir de Windows 10.
Encabezado	wdm.h (incluya Wudfwdm.h)

Consulte también

Administración del estado de rendimiento del dispositivo

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates