PowerRegisterForEffectivePowerModeNotifications 함수(powersetting.h)

효과적인 전원 모드 변경 알림을 수신하도록 콜백을 등록합니다.

구문

HRESULT PowerRegisterForEffectivePowerModeNotifications(
  ULONG                         Version,
  EFFECTIVE_POWER_MODE_CALLBACK *Callback,
  PVOID                         Context,
  PVOID                         *RegistrationHandle
);

매개 변수

Version

호출자가 이해하는 최대 유효 전원 모드 버전을 제공합니다. 유효 전원 모드가 이후 버전에서 제공되는 경우 호환되는 버전으로 축소된 다음 콜백에 전달됩니다.

다음 값을 전달할 수 있습니다.

• EFFECTIVE_POWER_MODE_V1 Windows 10, 버전 1809 시작하여 성능 전원 슬라이더 및 배터리 절약 모드 상태를 추적합니다.
• EFFECTIVE_POWER_MODE_V2 Windows 10 버전 1903부터 사용할 수 있으며 성능 전원 슬라이더, 배터리 절약 모드, 게임 모드 및 Windows 혼합 현실 전원 상태를 추적합니다.

Callback

유효 전원 모드가 변경되면 호출할 콜백에 대한 포인터입니다. 또한 현재 모드를 제공하기 위해 등록 시 한 번 호출됩니다. 이 API를 사용하여 여러 콜백을 등록하는 경우 이러한 콜백을 동시에 호출할 수 있습니다.

Context

호출자가 지정한 불투명 컨텍스트입니다.

RegistrationHandle

등록에 대한 핸들입니다. 이 핸들을 사용하여 알림 등록을 취소합니다.

반환 값

호출에 성공하면 S_OK(0)을 반환하고 호출에 실패한 경우 0이 아닌 값을 반환합니다.

설명

등록 직후 전원 설정의 현재 값으로 콜백이 호출됩니다. 전원 모드가 변경되는 동안 등록이 발생하면 여러 콜백을 받을 수 있습니다. 마지막 콜백은 최신 업데이트입니다.

요구 사항

지원되는 최소 클라이언트	Windows 10, 버전 1809[데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	powersetting.h
라이브러리	Powrprof.lib
DLL	Powrprof.dll