Compartilhar via

Função PowerReadSettingAttributes (powrprof.h)

Retorna o atributo atual da configuração de energia especificada. Se o parâmetro SubGroupGuid for NULL , o atributo para PowerSettingGuid será retornado. Se o parâmetro PowerSettingGuid for NULL , o atributo para SubGroupGuid será retornado. Se os parâmetros SubGroupGuid e PowerSettingGuid forem válidos, o valor retornado será a combinação (OR bit a bit) dos atributos do subgrupo e da configuração de energia.

Sintaxe

DWORD PowerReadSettingAttributes(
  [in] const GUID *SubGroupGuid,
  [in] const GUID *PowerSettingGuid
);

Parâmetros

[in] SubGroupGuid

O subgrupo de configurações de energia. Esse parâmetro pode ser um dos seguintes valores definidos em WinNT.h. Use NO_SUBGROUP_GUID para se referir ao esquema de energia padrão.

Esses valores são os valores de subgrupo incluídos no Windows.

Valor Significado
NO_SUBGROUP_GUID
fea3413e-7e05-4911-9a71-700331f1c294
 As configurações nesse subgrupo fazem 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] PowerSettingGuid

O identificador da configuração de energia que está sendo usada.

Retornar valor

Retorna os atributos atuais de configuração de energia da configuração de energia especificada. O atributo é uma combinação dos atributos da configuração de energia e os atributos de seu subgrupo.

Valor/código retornado Descrição
POWER_ATTRIBUTE_HIDE
1
 Ocultar essa configuração de energia.

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

Funções de gerenciamento de energia

  • Last updated on