IWDFDevice2::GetSystemPowerAction 메서드(wudfddi.h)

  • 아티클

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

GetSystemPowerAction 메서드는 컴퓨터에 대해 현재 발생하는 시스템 전원 작업(있는 경우)을 반환합니다.

구문

POWER_ACTION GetSystemPowerAction();

반환 값

GetSystemPowerAction 은 POWER_ACTION 형식의 열거자 값을 반환합니다. 값은 컴퓨터에 대해 현재 발생하는 시스템 전원 동작 을 나타냅니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

설명

GetSystemPowerAction 메서드를 사용하면 드라이버가 디바이스가 유휴 상태(또는 절전 모드 해제)되어 있거나 전체 컴퓨터가 저전력 상태로 전환(또는 나가기)하기 때문에 디바이스의 전원 전환이 발생하는지 여부를 확인할 수 있습니다.

드라이버는 디바이스가 저전력 상태로 들어가거나 작업 상태로 돌아갈 때 프레임워크가 호출하는 이벤트 콜백 함수에서만 GetSystemPowerAction을 호출해야 합니다.

GetSystemPowerAction이 반환하는 값은 다음과 같은 상황에 따라 달라집니다.

  • 드라이버가 GetSystemPowerAction을 호출할 때 컴퓨터가 저전력 상태로 진입하는 경우 메서드는 컴퓨터가 저전력 상태로 진입하는 이유를 반환합니다. 예를 들어 컴퓨터가 S1, S2 또는 S3 저전력 상태로 진입하는 경우 메서드는 PowerActionSleep 을 반환합니다.
  • 드라이버가 GetSystemPowerAction을 호출할 때 컴퓨터가 저전력 상태에서 작동 중(S0) 상태로 돌아가는 경우 메서드는 컴퓨터가 저전력 상태로 진입한 이유를 반환합니다. 예를 들어 컴퓨터가 S1, S2 또는 S3 저전력 상태를 벗어나면 메서드는 PowerActionSleep 을 반환합니다.
  • 드라이버가 GetSystemPowerAction을 호출할 때 컴퓨터의 전원이 켜진 경우(꺼진 후) 메서드는 PowerActionNone을 반환합니다.
  • 드라이버가 GetSystemPowerAction을 호출할 때 디바이스가 저전력 유휴 상태로 전환되거나 작동 중(D0) 상태로 돌아오는 경우 나머지 시스템은 S0(작동 중) 상태로 유지되면 메서드는 PowerActionNone을 반환합니다.
  • 드라이버가 GetSystemPowerAction을 호출할 때 컴퓨터와 디바이스가 모두 작동 상태에 있는 경우 메서드는 PowerActionNone을 반환합니다.
저전력 상태에 대한 자세한 내용은 디바이스가 Low-Power 상태를 입력을 참조하세요.

예제

다음 코드 예제에서는 IWDFDevice2 인터페이스를 가져온 다음 GetSystemPowerAction을 호출합니다.

   IWDFDevice2 *pDevice2 = NULL;
    HRESULT hrQI = pDevice->QueryInterface(IID_PPV_ARGS(&pDevice2));
    if (SUCCEEDED(hrQI))
    {
        POWER_ACTION powerAction = pDevice2->GetSystemPowerAction();
    }
...
    SAFE_RELEASE(pDevice2);

요구 사항

요구 사항 값
지원 종료 UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼 데스크톱
최소 UMDF 버전 1.9
머리글 wudfddi.h(Wudfddi.h 포함)
DLL WUDFx.dll

추가 정보

IWDFDevice2