estrutura SYSTEM_POWER_STATE_CONTEXT (wdm.h)

A estrutura SYSTEM_POWER_STATE_CONTEXT é uma estrutura de sistema parcialmente opaca que contém informações sobre os estados de energia do sistema anteriores de um computador.

Sintaxe

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;

Membros

DUMMYUNIONNAME

União sem nome.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

Estrutura sem nome.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved1

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.TargetSystemState

O estado de energia do sistema de destino do IRP de energia do sistema anterior que o driver recebeu. Esse membro é definido como um valor de enumeração SYSTEM_POWER_STATE . Os drivers devem tratar esse membro como somente leitura.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.EffectiveSystemState

O estado efetivo de energia do sistema anterior, conforme percebido pelo usuário. Esse membro é definido como um valor de enumeração SYSTEM_POWER_STATE . Os drivers devem tratar esse membro como somente leitura. Esse valor de membro pode não corresponder ao membro TargetSystemState se, por exemplo, o IRP de energia do sistema anterior indicasse que o computador estava prestes a entrar em hibernação, mas ocorreu um desligamento híbrido para preparar o computador para uma inicialização rápida. Para obter mais informações, consulte Comentários.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.CurrentSystemState

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.IgnoreHibernationPath

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.PseudoTransition

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.KernelSoftReboot

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved2

Membro opaco. Reservado para uso do sistema.

DUMMYUNIONNAME.ContextAsUlong

Membro opaco. Reservado para uso do sistema.

Comentários

A partir do Windows Vista, o local da pilha de E/S em um IRP de energia do sistema contém uma estrutura SYSTEM_POWER_STATE_CONTEXT . O membro Power da estrutura IO_STACK_LOCATION contém um membro SystemPowerStateContext , que é uma estrutura SYSTEM_POWER_STATE_CONTEXT . Para obter mais informações, consulte IO_STACK_LOCATION.

O tamanho da estrutura de SYSTEM_POWER_STATE_CONTEXT é de quatro bytes. Essa estrutura é dividida em campos de bits, a maioria opaco para drivers e reservado exclusivamente para uso pelo sistema operacional. No entanto, dois desses campos de bits, TargetSystemState e EffectiveSystemState, podem ser lidos por drivers no modo kernel para distinguir uma inicialização rápida de uma inicialização de ativação de hibernação. Para obter mais informações, consulte Distinguindo a inicialização rápida do wake-from-Hibernation.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível a partir do Windows Vista.
Cabeçalho	wdm.h (inclua Ntpoapi.h)

Confira também

IO_STACK_LOCATION

SYSTEM_POWER_STATE