SYSTEM_POWER_STATE_CONTEXT-Struktur (wdm.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 erhalten hat. Dieses Element ist 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. Dieses Element ist 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 wird, sondern stattdessen ein hybrides Herunterfahren aufgetreten ist, 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

Undurchsichtiges Element. Ist für das System reserviert.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition

Undurchsichtiges Element. Ist für das System reserviert.

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 einer Systemleistungs-IRP eine SYSTEM_POWER_STATE_CONTEXT Struktur. Das Power-Element der IO_STACK_LOCATION-Struktur enthält ein SystemPowerStateContext-Element , 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 Bytes. 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 Unterscheiden des schnellen Startvorgangs von "Wake-from-Hibernation".

Anforderungen

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

Weitere Informationen

IO_STACK_LOCATION

SYSTEM_POWER_STATE