structure SYSTEM_POWER_STATE_CONTEXT (ntpoapi.h)
La structure SYSTEM_POWER_STATE_CONTEXT est une structure système partiellement opaque qui contient des informations sur les états d’alimentation du 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 non nommée.
DUMMYUNIONNAME.DUMMYSTRUCTNAME
Structure sans nom.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved1
Membre opaque. Réservé à l’utilisation du système.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.TargetSystemState
État de l’alimentation du système cible de l’IRP d’alimentation du système précédent que le pilote a reçu. Ce membre est défini sur une valeur d’énumération SYSTEM_POWER_STATE. Les pilotes doivent traiter ce membre en lecture seule.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.EffectiveSystemState
État d’alimentation du système précédent effectif, tel qu’il est 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 en lecture seule. Cette valeur de membre peut ne pas correspondre au membre TargetSystemState si, par exemple, le système précédent a indiqué 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 pour un démarrage rapide. Pour plus d’informations, consultez Remarques.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.CurrentSystemState
Membre opaque. Réservé à l’utilisation du système.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.IgnoreHibernationPath
Membre opaque. Réservé à l’utilisation du système.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.PseudoTransition
Membre opaque. Réservé à l’utilisation du système.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.KernelSoftReboot
DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition
une transition drIPS dirigée.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved2
Membre opaque. Réservé à l’utilisation du système.
DUMMYUNIONNAME.ContextAsUlong
Membre opaque. Réservé à l’utilisation du système.
Remarques
À compter de Windows Vista, l’emplacement de la pile d’E/S dans un système power IRP 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 pour les 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 distinguer le démarrage rapide de Wake-from-Hibernation.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows Vista. |
| d’en-tête | ntpoapi.h (include Ntpoapi.h) |