PowerReadDCValueIndex-Funktion (powrprof.h)

  • Artikel

Ruft den DC-Wertindex der angegebenen Leistungseinstellung ab.

Syntax

DWORD PowerReadDCValueIndex(
  [in, optional] HKEY       RootPowerKey,
  [in, optional] const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [out]          LPDWORD    DcValueIndex
);

Parameter

[in, optional] RootPowerKey

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

[in, optional] SchemeGuid

Der Bezeichner des Energieschemas.

[in, optional] SubGroupOfPowerSettingsGuid

Der Bezeichner der Untergruppe der Energieeinstellungen. 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, optional] PowerSettingGuid

Der Bezeichner der Energieeinstellung.

[out] DcValueIndex

Ein Zeiger auf eine Variable, die den DC-Wertindex empfängt.

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ohne Zero, 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