PowerReadSettingAttributes-Funktion (powrprof.h)

Artikel
08/25/2023

Gibt das aktuelle Attribut der angegebenen Energieeinstellung zurück. Wenn der SubGroupGuid-ParameterNULL ist, wird das Attribut für PowerSettingGuid zurückgegeben. Wenn der PowerSettingGuid-ParameterNULL ist, wird das Attribut für SubGroupGuid zurückgegeben. Wenn sowohl die Parameter SubGroupGuid als auch PowerSettingGuid gültig sind, ist der Rückgabewert die Kombination (bitweise OR) der Attribute der Untergruppe und der Energieeinstellung.

Syntax

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

Parameter

[in] SubGroupGuid

Die Untergruppe der Energieeinstellungen. Dieser Parameter kann einer der folgenden Werte sein, die in WinNT.h definiert sind. Verwenden Sie NO_SUBGROUP_GUID , um auf das Standardenergieschema zu verweisen.

Diese Werte sind die Untergruppenwerte, die in Windows enthalten sind.

Wert	Bedeutung
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Einstellungen in dieser Untergruppe sind Teil des Standardenergieschemas.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	Einstellungen in dieser Untergruppe steuern die Energieverwaltungskonfiguration der Festplattenlaufwerke des Systems.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Einstellungen in dieser Untergruppensteuerungskonfiguration der Netzschaltflächen des Systems.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Einstellungen in dieser Untergruppensteuerungskonfiguration der Prozessorleistungsverwaltungsfunktionen.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Einstellungen in dieser Untergruppensteuerungskonfiguration der Videoenergieverwaltungsfeatures.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Die Einstellungen in dieser Untergruppe steuern Die Auslösepunkte und Aktionen des Batteriealarms.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Einstellungen in diesen Untergruppensteuerungsmoduseinstellungen.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Einstellungen in dieser Untergruppe steuern PCI-Express-Einstellungen.

[in] PowerSettingGuid

Der Bezeichner der verwendeten Energieeinstellung.

Rückgabewert

Gibt die aktuellen Energieeinstellungsattribute der angegebenen Energieeinstellung zurück. Das Attribut ist eine Kombination aus den Attributen der Leistungseinstellung und den Attributen ihrer Untergruppe.

Rückgabecode/-wert	BESCHREIBUNG
POWER_ATTRIBUTE_HIDE 1	Blenden Sie diese Energieeinstellung aus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	powrprof.h
Bibliothek	PowrProf.lib
DLL	PowrProf.dll

Weitere Informationen

Energieverwaltungsfunktionen

Freigeben über