Compartilhar via


estrutura SYSTEM_POWER_STATE_CONTEXT (ntpoapi.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 um desligamento híbrido ocorreu 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

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition

uma transição de DRIPS Direcionada.

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 SYSTEM_POWER_STATE_CONTEXT é de quatro bytes. Essa estrutura é dividida em campos de bits, a maioria opacos para drivers e reservados exclusivamente para uso pelo sistema operacional. No entanto, dois desses campos de bits, TargetSystemState e EffectiveSystemState, podem ser lidos por drivers de modo kernel para distinguir uma inicialização rápida de uma inicialização de ativação da hibernação. Para obter mais informações, consulte Distinguindo a inicialização rápida da ativação da hibernação.

Requisitos

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

Confira também

IO_STACK_LOCATION

SYSTEM_POWER_STATE