estructura PEP_QUERY_COMPONENT_PERF_SET_NAME (pepfx.h)

La estructura PEP_QUERY_COMPONENT_PERF_SET_NAME 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_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

Miembros

[in] DeviceHandle

Valor PEPHANDLE que identifica el dispositivo. El PEP proporcionó este identificador en respuesta a una notificación de PEP_DPM_REGISTER_DEVICE anterior.

[in] 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.

[in] 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 .

[in, NameSize

En la entrada, el tamaño, en bytes, del búfer al que apunta el miembro Name . Si Name es NULL, el PEP sobrescribe el valor de entrada de NameSize con el tamaño de búfer necesario para la cadena de nombre.

[in] Name

Puntero a un búfer de salida. El PEP escribe el nombre del estado P en este búfer. El nombre se almacena como una cadena terminada en null de caracteres anchos. El miembro Name es NULL si el marco de administración de energía de Windows (PoFx) debe determinar el tamaño de un búfer que se va a asignar para la cadena de nombre. Si Name no es NULL, el búfer debe ser lo suficientemente grande como para contener toda la cadena, incluido el carácter nulo de terminación.

Comentarios

La notificación de PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME usa esta estructura. Los miembros DeviceHandle, Component y Set de la estructura contienen valores de entrada proporcionados por PoFx cuando se envía esta notificación. Si el miembro Name no es NULL, el PEP escribe una cadena en el búfer al que apunta Name. Si Name es NULL, PEP escribe el tamaño de búfer necesario en el miembro NameSize .

La cadena que escribe el PEP en el búfer de salida debe contener un nombre descriptivo para el conjunto de estados P. Este nombre está diseñado para facilitar la comprensión de las entradas de registro y los mensajes de diagnóstico.

Requisitos

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

Consulte también

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE