SYSTEM_POWER_STATE-Enumeration (ntpoapi.h)

Artikel
08/07/2023

Der SYSTEM_POWER_STATE Enumerationstyp wird verwendet, um einen Systemleistungszustand anzugeben.

Syntax

typedef enum _SYSTEM_POWER_STATE {
  PowerSystemUnspecified,
  PowerSystemWorking,
  PowerSystemSleeping1,
  PowerSystemSleeping2,
  PowerSystemSleeping3,
  PowerSystemHibernate,
  PowerSystemShutdown,
  PowerSystemMaximum
} SYSTEM_POWER_STATE, *PSYSTEM_POWER_STATE;

Konstanten


`PowerSystemUnspecified` Gibt einen nicht angegebenen Systemleistungszustand an.
`PowerSystemWorking` Gibt die maximale Systemleistung an, die dem Systemarbeitszustand S0 entspricht.
`PowerSystemSleeping1` Gibt einen Systemzustand an, der kleiner als PowerSystemWorking und größer als PowerSystemSleeping2 ist, was dem Systemleistungszustand S1 entspricht.
`PowerSystemSleeping2` Gibt einen Systemzustand an, der kleiner als PowerSystemSleeping1 und größer als PowerSystemSleeping3 ist, was dem Systemleistungszustand S2 entspricht.
`PowerSystemSleeping3` Gibt einen Systemzustand an, der kleiner als PowerSystemSleeping2 und größer als PowerSystemHibernate ist, was dem Systemleistungszustand S3 entspricht.
`PowerSystemHibernate` Gibt den niedrigsten Ruhezustand an, der dem Systemleistungszustand S4 entspricht.
`PowerSystemShutdown` Gibt an, dass das System deaktiviert ist, was dem Systemstillstand S5 entspricht.
`PowerSystemMaximum` Die Anzahl der Systemleistungszustandswerte für diesen Enumerationstyp, der die tatsächlichen Energiezustände darstellt. Dieser Wert ist die Anzahl der Elemente im DeviceState-Member der DEVICE_CAPABILITIES-Struktur für ein Gerät. Die anderen Systemleistungsstatuswerte sind kleiner als dieser Wert.

Hinweise

Ein Energiezustand gibt die Höhe des Energieverbrauchs – und damit das Ausmaß der Rechenaktivität – durch das System oder ein einzelnes Gerät an. Der Energie-Manager legt den Energiezustand des Systems als Ganzes fest, wobei der Systemleistungszustand durch einen der Werte des SYSTEM_POWER_STATE Enumerationstyps angegeben wird. Gerätetreiber legen den Leistungszustand ihrer einzelnen Geräte fest, wobei der Energiezustand des Geräts durch einen der Werte des DEVICE_POWER_STATE Enumerationstyps angegeben wird.

Weitere Informationen zu Systemleistungszuständen finden Sie unter Behandeln von Systemstromzustandsanforderungen und weitere Informationen zu Gerätestromzuständen finden Sie unter Verwalten von Energie für einzelne Geräte.

Weitere Informationen zur Energieverwaltung im Allgemeinen finden Sie unter Einführung in die Energieverwaltung.

Anforderungen

Anforderung	Wert
Header	ntpoapi.h (einschließen Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Weitere Informationen

DEVICE_POWER_STATE

Freigeben über