Compartir a través de

estructura PEP_QUERY_COMPONENT_PERF_SET (pepfx.h)

  • Artículo

La estructura PEP_QUERY_COMPONENT_PERF_SET contiene información de consulta sobre un conjunto de valores de estado de rendimiento (conjunto de estado 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 de 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 componentes van de 0 a N-1.

Set

Índice que identifica este conjunto de estado P. Si este componente tiene conjuntos de estado de M, los índices de conjuntos 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. Actualmente no se definen bits de marca 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 estado 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 estado 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 de este conjunto de estado P. Este valor se expresa en las unidades de medida indicadas por el miembro unidad de .

Range.Maximum

Valor máximo en el intervalo de valores de rendimiento de este conjunto de estado P. Este valor se expresa en las unidades de medida indicadas por el miembro unidad de .

Observaciones

La notificación de PEP_DPM_QUERY_COMPONENT_PERF_SET usa esta estructura. El DeviceHandle, Component, Sety Flags members 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 discrete o Range contiene un valor de salida que el PEP escribe en la estructura en respuesta a la notificación.

La unión sin nombre contiene 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.

Requisitos

Requisito Valor
cliente mínimo admitido Se admite a partir de Windows 10.
encabezado de pepfx.h (include Pep_x.h)

Consulte también