PoRegisterForEffectivePowerModeNotifications 함수는 효과적인 전원 모드 변경 알림을 수신하기 위한 콜백을 등록합니다.
구문
NTSTATUS PoRegisterForEffectivePowerModeNotifications(
ULONG Version,
PPO_EFFECTIVE_POWER_MODE_CALLBACK Callback,
PVOID Context,
PO_EPM_HANDLE *RegistrationHandle,
PDEVICE_OBJECT DeviceObject
);
매개 변수
Version
호출자가 이해하는 최대 유효 전원 모드 버전을 제공합니다. 유효 전원 모드가 이후 버전에서 제공되는 경우 호환되는 버전에 매핑된 다음 콜백에 전달됩니다.
다음 값을 전달할 수 있습니다.
EFFECTIVE_POWER_MODE_V1 Windows 10, 버전 1809 시작하여 성능 전원 슬라이더 및 에너지 절약 모드 상태를 추적합니다.
EFFECTIVE_POWER_MODE_V2 Windows 10 버전 1903부터 사용할 수 있으며 성능 전원 슬라이더, 배터리 절약 모드, 게임 모드 및 Windows 혼합 현실 전원 상태를 추적합니다.
Callback
유효 전원 모드가 변경되면 호출할 콜백에 대한 포인터입니다. 또한 현재 모드를 제공하기 위해 등록 시 한 번 호출됩니다. 여러 콜백이 등록된 경우 이러한 콜백을 동시에 호출할 수 있습니다.
Context
호출자가 지정한 불투명 컨텍스트입니다.
RegistrationHandle
등록에 대한 핸들을 수신하는 변수에 대한 포인터입니다. 이 핸들은 콜백 함수의 등록을 취소하는 데 사용할 수 있습니다.
DeviceObject
지정된 경우 지정된 디바이스 컨텍스트와 함께 등록된 콜백(예: 드라이버)을 제공하는 선택적 매개 변수입니다.
반환 값
호출에 성공하면 S_OK (0)을 반환하고 호출에 실패한 경우 0이 아닌 값을 반환합니다.
설명
등록 직후 전원 설정의 현재 값으로 콜백이 호출됩니다. 전원 모드가 변경되는 동안 등록이 발생하는 경우 여러 콜백을 받을 수 있습니다. 마지막 콜백은 최신 업데이트입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 11 버전 24H2 |
| 머리글 | wdm.h(Wdm.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |