estructura de PEP_QUERY_COMPONENT_PERF_SET (pep_x.h)
La estructura PEP_QUERY_COMPONENT_PERF_SET contiene información de consulta sobre un conjunto de valores de estado de rendimiento (conjunto de estados P) para un componente.
Sintaxis
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;
Miembros
DeviceHandle
Valor PEPHANDLE que identifica el dispositivo. El PEP proporcionó este identificador en respuesta a una notificación de PEP_DPM_REGISTER_DEVICE anterior.
Component
Índice que identifica el componente. Este miembro es un índice en la matriz Components de la estructura PEP_DEVICE_REGISTER_V2 que el PEP proporcionó anteriormente en respuesta a la notificación de PEP_DPM_REGISTER_DEVICE para este dispositivo. Si la matriz Components contiene N elementos, los índices de componente oscilan entre 0 y N-1.
Set
Índice que identifica este conjunto de estados P. Si este componente tiene conjuntos de M P-state, los índices del conjunto de estado P van de 0 a M-1. El PEP especificó previamente el número de conjuntos de estado P en respuesta a una notificación de PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .
Flags
Un conjunto de marcas de entrada. No hay bits de marca definidos actualmente para este miembro, que siempre es cero.
Unit
Valor de enumeración PEP_PERF_STATE_UNIT que indica si los valores de este conjunto de estados P se expresan en hercios (unidades de frecuencia) o bits por segundo (unidades de ancho de banda).
Type
Valor de enumeración PEP_PERF_STATE_TYPE que indica si los valores de rendimiento de este conjunto de estados P se expresan como una lista de valores discretos o como un intervalo continuo de valores.
Discrete
Use esta estructura si Type == PepPerfStateTypeDiscrete.
Discrete.Count
Número de valores de rendimiento discretos en este conjunto de estados P.
Range
Use esta estructura si Type == PepPerfStateTypeRange.
Range.Minimum
Valor mínimo en el intervalo de valores de rendimiento para este conjunto de estados P. Este valor se expresa en las unidades de medida indicadas por el miembro Unit .
Range.Maximum
Valor máximo en el intervalo de valores de rendimiento para este conjunto de estados P. Este valor se expresa en las unidades de medida indicadas por el miembro Unit .
Comentarios
La unión sin nombre representa el número de valores de rendimiento discretos de este conjunto de estados P o el intervalo de valores de este conjunto de estados P.
La notificación de PEP_DPM_QUERY_COMPONENT_PERF_SET usa esta estructura. Los miembros DeviceHandle, Component, Set y Flags contienen valores de entrada proporcionados por el marco de administración de energía de Windows (PoFx) cuando se envía esta notificación. El miembro discreto o el miembro Range contiene un valor de salida que el PEP escribe en la estructura en respuesta a la notificación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows 10. |
| Encabezado | pep_x.h (incluya Pep_x.h) |