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 estado 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 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.
[in] 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.
[in, NameSize
En la entrada, el tamaño, en bytes, del búfer al que apunta el miembro Nombre. Si Nombre 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 de caracteres anchos y terminada en NULL. 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 Nombre 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.
Observaciones
La notificación de PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME usa esta estructura. El DeviceHandle , Componenty Set miembros de la estructura contienen valores de entrada proporcionados por PoFx cuando se envía esta notificación. Si el miembro Name no es NULL, pep escribe una cadena en el búfer al que apunta Nombre. Si Name es NULL, PEP escribe el tamaño de búfer necesario en el miembro NameSize.
La cadena que el PEP escribe en el búfer de salida debe contener un nombre descriptivo para el conjunto de estados P. Este nombre está pensado para facilitar la comprensión de las entradas de registro y los mensajes de diagnóstico.
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
PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES