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