SYSTEM_POWER_STATE_CONTEXT-Struktur (ntpoapi.h)

Die SYSTEM_POWER_STATE_CONTEXT-Struktur ist eine teilweise undurchsichtige Systemstruktur, die Informationen zu den vorherigen Systemleistungszuständen eines Computers enthält.

Syntax

typedef struct _SYSTEM_POWER_STATE_CONTEXT {
  union {
    struct {
      ULONG Reserved1 : 8;
      ULONG TargetSystemState : 4;
      ULONG EffectiveSystemState : 4;
      ULONG CurrentSystemState : 4;
      ULONG IgnoreHibernationPath : 1;
      ULONG PseudoTransition : 1;
      ULONG KernelSoftReboot : 1;
      ULONG DirectedDripsTransition : 1;
      ULONG Reserved2 : 8;
    } DUMMYSTRUCTNAME;
    ULONG ContextAsUlong;
  } DUMMYUNIONNAME;
} SYSTEM_POWER_STATE_CONTEXT, *PSYSTEM_POWER_STATE_CONTEXT;

Member

DUMMYUNIONNAME

Unbenannte Union.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

Unbenannte Struktur.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved1

Undurchsichtiges Element. Ist für das System reserviert.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.TargetSystemState

Der Leistungszustand des Zielsystems des vorherigen Systemleistungs-IRP , den der Treiber empfangen hat. Dieser Member wird auf einen SYSTEM_POWER_STATE Enumerationswert festgelegt. Treiber sollten dieses Element als schreibgeschützt behandeln.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.EffectiveSystemState

Der effektive vorherige Systemleistungszustand, wie er vom Benutzer wahrgenommen wird. Dieser Member wird auf einen SYSTEM_POWER_STATE Enumerationswert festgelegt. Treiber sollten dieses Element als schreibgeschützt behandeln. Dieser Memberwert stimmt möglicherweise nicht mit dem TargetSystemState-Member überein, wenn z. B. die vorherige Systemleistungs-IRP angibt, dass der Computer in den Ruhezustand versetzt werden soll, aber stattdessen ein hybrides Herunterfahren erfolgte, um den Computer auf einen schnellen Start vorzubereiten. Weitere Informationen finden Sie in den Hinweisen.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.CurrentSystemState

Undurchsichtiges Element. Ist für das System reserviert.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.IgnoreHibernationPath

Undurchsichtiges Element. Ist für das System reserviert.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.PseudoTransition

Undurchsichtiges Element. Ist für das System reserviert.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.KernelSoftReboot

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition

ein gerichteter DRIPS-Übergang.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved2

Undurchsichtiges Element. Ist für das System reserviert.

DUMMYUNIONNAME.ContextAsUlong

Undurchsichtiges Element. Ist für das System reserviert.

Hinweise

Ab Windows Vista enthält der E/A-Stapelspeicherort in einem Systemleistungs-IRP eine SYSTEM_POWER_STATE_CONTEXT-Struktur . Das Power-Element der IO_STACK_LOCATION-Struktur enthält einen SystemPowerStateContext-Member , bei dem es sich um eine SYSTEM_POWER_STATE_CONTEXT-Struktur handelt. Weitere Informationen finden Sie unter IO_STACK_LOCATION.

Die Größe der SYSTEM_POWER_STATE_CONTEXT-Struktur beträgt vier Byte. Diese Struktur ist in Bitfelder unterteilt, von denen die meisten für Treiber undurchsichtig sind und ausschließlich für die Verwendung durch das Betriebssystem reserviert sind. Zwei dieser Bitfelder, TargetSystemState und EffectiveSystemState, können jedoch von Kernelmodustreibern gelesen werden, um einen schnellen Start von einem Wake-from-Hibernation-Start zu unterscheiden. Weitere Informationen finden Sie unter Distinguishing Fast Startup from Wake-from-Hibernation.For more information, see Distinguishing Fast Startup from Wake-from-Hibernation.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows Vista.
Kopfzeile ntpoapi.h (ntpoapi.h einschließen)

Weitere Informationen

IO_STACK_LOCATION

SYSTEM_POWER_STATE