SYSTEM_POWER_STATE_CONTEXT structure (ntpoapi.h)

  • Article

La structure SYSTEM_POWER_STATE_CONTEXT est une structure système partiellement opaque qui contient des informations sur les états d’alimentation système précédents d’un ordinateur.

Syntaxe

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;

Membres

DUMMYUNIONNAME

Union sans nom.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

Structure sans nom.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved1

Membre opaque. Réservé pour le système.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.TargetSystemState

État d’alimentation du système cible de l’IRP d’alimentation système précédent reçu par le pilote. Ce membre est défini sur une valeur d’énumération SYSTEM_POWER_STATE . Les pilotes doivent traiter ce membre comme en lecture seule.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.EffectiveSystemState

État d’alimentation précédent effectif du système, tel que perçu par l’utilisateur. Ce membre est défini sur une valeur d’énumération SYSTEM_POWER_STATE . Les pilotes doivent traiter ce membre comme en lecture seule. Cette valeur de membre peut ne pas correspondre au membre TargetSystemState si, par exemple, l’IRP d’alimentation système précédent indiquait que l’ordinateur était sur le point d’entrer en veille prolongée, mais qu’un arrêt hybride s’est produit à la place pour préparer l’ordinateur à un démarrage rapide. Pour plus d'informations, consultez la section Notes.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.CurrentSystemState

Membre opaque. Réservé pour le système.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.IgnoreHibernationPath

Membre opaque. Réservé pour le système.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.PseudoTransition

Membre opaque. Réservé pour le système.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.KernelSoftReboot

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition

une transition DRIPS dirigée.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved2

Membre opaque. Réservé pour le système.

DUMMYUNIONNAME.ContextAsUlong

Membre opaque. Réservé pour le système.

Remarques

À compter de Windows Vista, l’emplacement de la pile d’E /S dans un IRP d’alimentation système contient une structure SYSTEM_POWER_STATE_CONTEXT . Le membre Power de la structure IO_STACK_LOCATION contient un membre SystemPowerStateContext , qui est une structure SYSTEM_POWER_STATE_CONTEXT . Pour plus d’informations, consultez IO_STACK_LOCATION.

La taille de la structure SYSTEM_POWER_STATE_CONTEXT est de quatre octets. Cette structure est divisée en champs de bits, dont la plupart sont opaques aux pilotes et réservés exclusivement pour une utilisation par le système d’exploitation. Toutefois, deux de ces champs de bits, TargetSystemState et EffectiveSystemState, peuvent être lus par les pilotes en mode noyau pour distinguer un démarrage rapide d’un démarrage en veille prolongée. Pour plus d’informations, consultez Distinction du démarrage rapide de la mise en veille prolongée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows Vista.
En-tête ntpoapi.h (incluez Ntpoapi.h)

Voir aussi

IO_STACK_LOCATION

SYSTEM_POWER_STATE