estructura PEP_PPM_FEEDBACK_READ (pepfx.h)

  • Artículo

La estructura PEP_PPM_FEEDBACK_READ contiene el valor leído de un contador de comentarios de rendimiento del procesador.

Sintaxis

typedef struct _PEP_PPM_FEEDBACK_READ {
  ULONG CounterIndex;
  union {
    ULONG64 InstantaneousValue;
    struct {
      ULONG64 NominalCount;
      ULONG64 ActualCount;
    };
  };
} PEP_PPM_FEEDBACK_READ, *PPEP_PPM_FEEDBACK_READ;

Miembros

CounterIndex

Índice de base cero que identifica el contador de comentarios de rendimiento del procesador que se va a leer. Si el complemento de extensión de plataforma (PEP) admite contadores N para este procesador, los índices de contador van de 0 a N-1. El PEP proporcionó previamente el número de contadores admitidos en respuesta a una notificación de PEP_NOTIFY_PPM_QUERY_CAPABILITIES .

InstantaneousValue

Valor instantáneo actual leído del contador, si el contador genera un valor instantáneo.

NominalCount

Valor acumulado nominal del contador. El valor acumulado es la suma de todos los valores reales que hasta ahora se han leído del hardware del contador.

ActualCount

Valor real leído del contador.

Comentarios

La notificación de PEP_NOTIFY_PPM_FEEDBACK_READ usa esta estructura. El miembro CounterIndex de la estructura contiene un valor de entrada proporcionado por el marco de administración de energía de Windows (PoFx) cuando se establece esta notificación. Los demás miembros contienen valores de salida que el PEP escribe en la estructura en respuesta a la notificación. El PEP escribe en el miembro InstantValue si el contador genera un valor instantáneo o en los miembros NominalCount y ActualCount si el contador genera un valor relativo.

Tanto un contador instantáneo como un contador relativo se restablecen a cero cuando la energía se activa por primera vez, pero la lectura de un contador relativo hace que el recuento se restablezca a cero, mientras que la lectura de un contador instantáneo no restablece el recuento. El PEP indicó previamente si el contador es instantáneo o relativo en respuesta a una notificación de PEP_NOTIFY_PPM_QUERY_FEEDBACK_COUNTERS .

La unión sin nombre contiene un valor de contador instantáneo, si el contador genera un valor instantáneo, o ambos valores de contador relativos y acumulados, si el hardware del contador genera un valor relativo. Para obtener más información, vea la sección Comentarios.

La estructura sin nombre contiene el recuento acumulado nominal y el recuento real, si el hardware del contador genera un valor relativo.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite a partir de Windows 10.
Encabezado pepfx.h (include Pep_x.h)

Consulte también