Compartir a través de

Función PowerReadSettingAttributes (powrprof.h)

  • Artículo

Devuelve el atributo actual de la configuración de energía especificada. Si el parámetro SubGroupGuid es NULL , se devuelve el atributo para PowerSettingGuid . Si el parámetro PowerSettingGuid es NULL , se devuelve el atributo para SubGroupGuid . Si los parámetros SubGroupGuid y PowerSettingGuid son válidos, el valor devuelto es la combinación (OR bit a bit) de los atributos del subgrupo y la configuración de energía.

Sintaxis

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

Parámetros

[in] SubGroupGuid

Subgrupo de la configuración de energía. Este parámetro puede ser uno de los siguientes valores definidos en WinNT.h. Use NO_SUBGROUP_GUID para hacer referencia al esquema de energía predeterminado.

Estos valores son los valores del subgrupo incluidos con Windows.

Valor Significado
NO_SUBGROUP_GUID
fea3413e-7e05-4911-9a71-700331f1c294
 La configuración de este subgrupo forma 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] PowerSettingGuid

Identificador de la configuración de energía que se está usando.

Valor devuelto

Devuelve los atributos de configuración de energía actuales de la configuración de energía especificada. El atributo es una combinación de los atributos de la configuración de energía y los atributos de su subgrupo.

Código o valor devuelto Descripción
POWER_ATTRIBUTE_HIDE
1
 Oculte esta configuración de energía.

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

Funciones de administración de energía