Share via

GetDevicePowerState 함수(winbase.h)

  • 아티클

지정된 디바이스의 현재 전원 상태를 검색합니다. 이 함수는 디스플레이 디바이스의 전원 상태를 쿼리하는 데 사용할 수 없습니다.

구문

BOOL GetDevicePowerState(
  [in]  HANDLE hDevice,
  [out] BOOL   *pfOn
);

매개 변수

[in] hDevice

파일 또는 소켓과 같은 디바이스의 개체에 대한 핸들 또는 디바이스 자체에 대한 핸들입니다.

[out] pfOn

전원 상태를 수신하는 변수에 대한 포인터입니다. 디바이스가 작업 상태인 경우 이 값은 TRUE 입니다. 그렇지 않으면 FALSE입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

애플리케이션은 GetDevicePowerState 를 사용하여 디바이스가 작동 상태인지 또는 저전력 상태인지 확인할 수 있습니다. 디바이스가 저전력 상태인 경우 디바이스에 액세스하면 I/O 요청을 큐에 넣거나 실패하거나 디바이스를 작업 상태로 전환할 수 있습니다. 정확한 동작은 디바이스 구현에 따라 달라집니다.

노트북 컴퓨터에서 배터리 사용 시간을 최대화하려면 GetDevicePowerState 를 사용하여 전력 소비를 줄입니다. 예를 들어 디스크의 전원이 현재 다운된 경우 디스크에 액세스하면 디스크가 스핀업되어 전력 소비가 증가하고 배터리 수명이 줄어듭니다.

애플리케이션은 시스템이 배터리 전원으로 실행되는 동안 가능한 한 디바이스에 대한 액세스를 연기하거나 제한해야 합니다. 시스템이 배터리 전원에서 실행 중인지 여부와 남은 배터리 수명을 확인하려면 GetSystemPowerStatus 함수를 사용합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winbase.h(Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

GetSystemPowerStatus

전원 관리 함수

시스템 전원 상태