PowerCreatePossibleSetting-Funktion (powrprof.h)

Artikel
03/01/2024

Erstellt einen möglichen Einstellungswert für eine angegebene Energieeinstellung.

Syntax

DWORD PowerCreatePossibleSetting(
  [in, optional] HKEY       RootSystemPowerKey,
  [in]           const GUID *SubGroupOfPowerSettingsGuid,
  [in]           const GUID *PowerSettingGuid,
  [in]           ULONG      PossibleSettingIndex
);

Parameter

[in, optional] RootSystemPowerKey

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf NULL festgelegt werden.

[in] SubGroupOfPowerSettingsGuid

Die Untergruppe der Energieeinstellungen. Dieser Parameter kann einer der folgenden Werte sein, die in WinNT.h definiert 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 Netzschalter des Systems.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Einstellungen in dieser Untergruppe steuern die Konfiguration der Prozessorleistungsverwaltungsfeatures.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Einstellungen in dieser Untergruppe steuern die Konfiguration der Videoenergieverwaltungsfeatures.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Die Einstellungen in dieser Untergruppe steuern Batteriealarmauslöserpunkte und -aktionen.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Einstellungen in dieser Untergruppe steuern die Einstellungen für den Ruhezustand des Systems.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Einstellungen in dieser Untergruppe steuern PCI Express-Einstellungen.

[in] PowerSettingGuid

Der Bezeichner der Energieeinstellung, die erstellt wird.

[in] PossibleSettingIndex

Der nullbasierte Index für die mögliche Einstellung, die erstellt wird.

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ungleich null, wenn der Aufruf fehlgeschlagen ist.

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