Función PowerEnumerate (powrprof.h)

Artículo
03/08/2023

Enumera los elementos especificados en un esquema de energía. Normalmente, se llama a esta función en un bucle que incrementa el parámetro Index para recuperar subclaves hasta que se hayan enumerado todos.

Sintaxis

DWORD PowerEnumerate(
  [in, optional]  HKEY                RootPowerKey,
  [in, optional]  const GUID          *SchemeGuid,
  [in, optional]  const GUID          *SubGroupOfPowerSettingsGuid,
  [in]            POWER_DATA_ACCESSOR AccessFlags,
  [in]            ULONG               Index,
  [out, optional] UCHAR               *Buffer,
  [in, out]       DWORD               *BufferSize
);

Parámetros

[in, optional] RootPowerKey

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

[in, optional] SchemeGuid

Identificador del esquema de energía. Si este parámetro es NULL, se devuelve una enumeración de las directivas de energía.

[in, optional] SubGroupOfPowerSettingsGuid

Subgrupo de la configuración de energía. Si este parámetro es NULL, se devuelve una enumeración de la configuración en la clave PolicyGuid .

Valor	Significado
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	La configuración de este subgrupo formará parte del esquema de energía predeterminado.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	La configuración de este subgrupo controla la configuración de administración de energía de las unidades de disco duro del sistema.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Configuración de esta configuración de control de subgrupo de los botones de encendido del sistema.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	La configuración de este subgrupo controla la configuración de las características de administración de energía del procesador.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Configuración de esta configuración de control de subgrupo de las características de administración de energía de vídeo.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	La configuración de este subgrupo controla los puntos y acciones de alarma de batería.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	La configuración de este subgrupo controla la configuración de suspensión del sistema.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	La configuración de este subgrupo controla la configuración de PCI Express.

[in] AccessFlags

Conjunto de marcas que especifica lo que se enumerará.

Valor	Significado
ACCESS_SCHEME 16	Enumerar esquemas de energía. Se omitirán los parámetros SchemeGuid y SubgroupOfPowerSettingsGuid .
ACCESS_SUBGROUP 17	Enumerar subgrupos en SchemeGuid. Se omitirá el parámetro SubgroupOfPowerSettingsGuid .
ACCESS_INDIVIDUAL_SETTING 18	Enumerar la configuración de energía individual en SchemeGuid\SubgroupOfPowerSettingsGuid. Para enumerar la configuración de energía directamente en la clave SchemeGuid , use NO_SUBGROUP_GUID como parámetro SubgroupOfPowerSettingsGuid .

[in] Index

Índice de base cero del esquema, subgrupo o valor que se está enumerando.

[out, optional] Buffer

Puntero a una variable para recibir los elementos. Si este parámetro es NULL, la función recupera el tamaño del búfer necesario.

[in, out] BufferSize

Puntero a una variable que en la entrada contiene el tamaño del búfer al que apunta el parámetro Buffer . Si el parámetro Buffer es NULL o si BufferSize no es lo suficientemente grande, la función devolverá ERROR_MORE_DATA y la variable recibe el tamaño de búfer necesario.

Valor devuelto

Devuelve ERROR_SUCCESS (cero) si la llamada se realizó correctamente y un valor distinto de cero si se produjo un error en la llamada. Si el tamaño del búfer pasado en el parámetro BufferSize es demasiado pequeño o si el parámetro Buffer es NULL, se devolverá ERROR_MORE_DATA y el parámetro DWORD al que apunta el parámetro BufferSize se rellenará con el tamaño de búfer necesario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	powrprof.h
Library	PowrProf.lib
Archivo DLL	PowrProf.dll

Consulte también

POWER_DATA_ACCESSOR

Funciones de administración de energía

Compartir a través de