SYSTEM_POWER_STATE_CONTEXT 구조체(wdm.h)

  • 아티클

SYSTEM_POWER_STATE_CONTEXT 구조는 컴퓨터의 이전 시스템 전원 상태에 대한 정보를 포함하는 부분적으로 불투명한 시스템 구조입니다.

구문

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;

멤버

DUMMYUNIONNAME

명명되지 않은 공용 구조체.

DUMMYUNIONNAME.DUMMYSTRUCTNAME

명명되지 않은 구조체입니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved1

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.TargetSystemState

드라이버가 받은 이전 시스템 전원 IRP의 대상 시스템 전원 상태입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 값으로 설정됩니다. 드라이버는 이 멤버를 읽기 전용으로 처리해야 합니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.EffectiveSystemState

사용자가 인식한 효과적인 이전 시스템 전원 상태입니다. 이 멤버는 SYSTEM_POWER_STATE 열거형 값으로 설정됩니다. 드라이버는 이 멤버를 읽기 전용으로 처리해야 합니다. 예를 들어 이전 시스템 전원 IRP에서 컴퓨터가 최대 절전 모드로 전환하려고 했지만 빠른 시작을 위해 컴퓨터를 준비하기 위해 하이브리드 종료가 발생한 경우 이 멤버 값이 TargetSystemState 멤버와 일치하지 않을 수 있습니다. 자세한 내용은 설명 부분을 참조하세요.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.CurrentSystemState

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.IgnoreHibernationPath

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.PseudoTransition

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.KernelSoftReboot

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.DirectedDripsTransition

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.Reserved2

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

DUMMYUNIONNAME.ContextAsUlong

불투명 멤버입니다. 시스템에서 사용하도록 예약되었습니다.

설명

Windows Vista부터 시스템 전원 IRP의 I/O 스택 위치에는 SYSTEM_POWER_STATE_CONTEXT 구조가 포함됩니다. IO_STACK_LOCATION 구조체의 Power 멤버에는 SYSTEM_POWER_STATE_CONTEXT 구조체인 SystemPowerStateContext 멤버가 포함됩니다. 자세한 내용은 IO_STACK_LOCATION 참조하세요.

SYSTEM_POWER_STATE_CONTEXT 구조체의 크기는 4바이트입니다. 이 구조는 비트 필드로 나뉘며, 대부분은 드라이버에 불투명하며 운영 체제에서 사용하기 위해 독점적으로 예약되어 있습니다. 그러나 이러한 두 비트 필드인 TargetSystemState 및 EffectiveSystemState는 커널 모드 드라이버에서 읽어 빠른 시작을 절전 모드 해제 시작과 구분할 수 있습니다. 자세한 내용은 절전 모드 해제 에서 최대 절전 모드에서 빠른 시작 구분을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista부터 사용할 수 있습니다.
머리글 wdm.h(Ntpoapi.h 포함)

추가 정보

IO_STACK_LOCATION

SYSTEM_POWER_STATE