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 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 van de 0 a 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 oscilan entre 0 y M-1. El PEP especificó previamente el número de conjuntos de estados 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 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 de 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 de este conjunto de estados P. Este valor se expresa en las unidades de medida indicadas por el miembro Unit .

Comentarios

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.

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 Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Encabezado pepfx.h (include Pep_x.h)

Consulte también