PowerSetRequest 함수(winbase.h)

  • 아티클

전원 요청 개체에 대해 지정된 형식의 전원 요청 수를 증분합니다.

구문

BOOL PowerSetRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

매개 변수

[in] PowerRequest

전원 요청 개체에 대한 핸들입니다.

[in] RequestType

증분할 전원 요청 형식입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 설명
PowerRequestDisplayRequired 장시간 사용자 입력이 없더라도 디스플레이는 계속 켜집니다.

참고: PowerRequestDisplayRequired 외에도 PowerRequestSystemRequired를 가져와야 디스플레이가 유지되고 시스템이 요청 기간 동안 절전 모드로 들어가지 않도록 해야 합니다.
PowerRequestSystemRequired 시스템이 사용자 비활성 기간 후에 절전 모드를 입력하는 대신 계속 실행됩니다.
PowerRequestAwayModeRequired 시스템이 사용자의 명시적 작업에 대한 응답으로 절전 모드 대신 어웨이 모드로 전환됩니다. 어웨이 모드에서는 시스템이 계속 실행되지만 오디오 및 비디오를 끄면 절전 모드가 표시됩니다. PowerRequestAwayModeRequired 는 기존 절전 모드(S3) 시스템에만 적용됩니다.
PowerRequestExecutionRequired 호출 프로세스는 프로세스 수명 관리 메커니즘에 의해 일시 중단되거나 종료되는 대신 계속 실행됩니다. 프로세스를 실행할 수 있는 시기와 기간은 운영 체제 및 전원 정책 설정에 따라 달라집니다.

기존 절전 모드(S3) 시스템에서 활성 PowerRequestExecutionRequired 요청은PowerRequestSystemRequired를 의미합니다.

반환 값

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

함수가 실패하면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

DC 전원의 최신 대기 시스템에서 시스템 및 실행 필수 전원 요청은 시스템 절전 모드 시간 제한이 만료된 후 5분 후에 종료됩니다.

기존 절전 모드(S3) 시스템에서 PowerRequestAwayModeRequired를 제외하고 사용자가 시작한 시스템 절전 모드 항목(전원 단추, 덮개 닫기 또는 시작 메뉴에서 절전 모드 선택)에 전원 요청이 종료됩니다.

전원을 절약하고 최상의 사용자 환경을 제공하려면 전원 요청을 사용하는 애플리케이션은 다음 모범 사례를 따라야 합니다.

  • 전원 요청을 만들 때 REASON_CONTEXT 구조에서 요청 이유를 설명하는 지역화된 텍스트 문자열을 제공합니다.
  • 요청이 필요한 시나리오 바로 전에 PowerSetRequest 를 호출합니다.
  • 시나리오가 완료되는 즉시 PowerClearRequest 를 호출하여 요청에 대한 참조 수를 감소합니다.
  • 프로세스가 종료되거나 서비스가 중지되기 전에 모든 요청 개체 및 연결된 핸들을 정리합니다.

요구 사항

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

참고 항목

PowerClearRequest

PowerCreateRequest