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_DPM_QUERY_COMPONENT_PERF_CAPABILITIES