Função PowerEnumerate (powrprof.h)

Artigo
08/25/2023

Enumera os elementos especificados em um esquema de energia. Essa função normalmente é chamada em um loop incrementando o parâmetro Index para recuperar subchaves até que todas elas tenham sido enumeradas.

Sintaxe

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

Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.

[in, optional] SchemeGuid

O identificador do esquema de energia. Se esse parâmetro for NULL, uma enumeração das políticas de energia será retornada.

[in, optional] SubGroupOfPowerSettingsGuid

O subgrupo de configurações de energia. Se esse parâmetro for NULL, uma enumeração de configurações na chave PolicyGuid será retornada .

Valor	Significado
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	As configurações nesse subgrupo farão parte do esquema de energia padrão.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	As configurações nesse subgrupo controlam a configuração de gerenciamento de energia das unidades de disco rígido do sistema.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	As configurações neste subgrupo controlam a configuração dos botões de energia do sistema.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	As configurações neste subgrupo controlam a configuração dos recursos de gerenciamento de energia do processador.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	As configurações nesse subgrupo controlam a configuração dos recursos de gerenciamento de energia de vídeo.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	As configurações nesse subgrupo controlam pontos e ações de corrida de alarme de bateria.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	As configurações neste subgrupo controlam as configurações de suspensão do sistema.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	As configurações neste subgrupo controlam as configurações do PCI Express.

[in] AccessFlags

Um conjunto de sinalizadores que especifica o que será enumerado

Valor	Significado
ACCESS_SCHEME 16	Enumerar esquemas de energia. Os parâmetros SchemeGuid e SubgroupOfPowerSettingsGuid serão ignorados.
ACCESS_SUBGROUP 17	Enumerar subgrupos em SchemeGuid. O parâmetro SubgroupOfPowerSettingsGuid será ignorado.
ACCESS_INDIVIDUAL_SETTING 18	Enumerar configurações de energia individuais em SchemeGuid\SubgroupOfPowerSettingsGuid. Para enumerar as configurações de energia diretamente na chave SchemeGuid , use NO_SUBGROUP_GUID como o parâmetro SubgroupOfPowerSettingsGuid .

[in] Index

O índice baseado em zero do esquema, subgrupo ou configuração que está sendo enumerado.

[out, optional] Buffer

Um ponteiro para uma variável para receber os elementos. Se esse parâmetro for NULL, a função recuperará o tamanho do buffer necessário.

[in, out] BufferSize

Um ponteiro para uma variável que na entrada contém o tamanho do buffer apontado pelo parâmetro Buffer . Se o parâmetro Buffer for NULL ou se BufferSize não for grande o suficiente, a função retornará ERROR_MORE_DATA e a variável receberá o tamanho do buffer necessário.

Retornar valor

Retornará ERROR_SUCCESS (zero) se a chamada tiver sido bem-sucedida e um valor diferente de zero se a chamada falhar. Se o tamanho do buffer passado no parâmetro BufferSize for muito pequeno ou se o parâmetro Buffer for NULL, ERROR_MORE_DATA será retornado e o DWORD apontado pelo parâmetro BufferSize será preenchido com o tamanho do buffer necessário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	powrprof.h
Biblioteca	PowrProf.lib
DLL	PowrProf.dll

Confira também

POWER_DATA_ACCESSOR

Funções de gerenciamento de energia

Compartilhar via