DXGK_BRIGHTNESS_SET 콜백 함수(dispmprt.h)
DxgkDdiSetBrightness 함수는 새 밝기 수준을 설정합니다.
구문
DXGK_BRIGHTNESS_SET DxgkBrightnessSet;
NTSTATUS DxgkBrightnessSet(
[in] PVOID Context,
[in] UCHAR Brightness
)
{...}
매개 변수
[in] Context
디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수는 이전에 이 핸들을 Microsoft DirectX 그래픽 커널 하위 시스템에 제공했습니다.
[in] Brightness
설정할 밝기 수준 값입니다.
반환 값
DxgkDdiSetBrightness 는 새 밝기 수준을 설정하는 데 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.
설명
모니터 드라이버는 디스플레이 미니포트 드라이버의 DxgkDdiSetBrightness 함수를 호출하여 다음과 같은 이유로 통합 디스플레이 패널의 밝기 수준을 변경합니다.
- DPPE(디바이스 전원 정책 엔진)의 알림은 현재 정책이 수정되었거나 새 정책이 적용됨을 나타냅니다. 새 DPPE 정책은 전원이 변경되는 경우뿐만 아니라 시스템 시작, 다시 시작 및 사용자 전환에도 적용됩니다.
- 사용자 모드 클라이언트가 밝기를 제어하는 기본 방법은 WMI(Windows Management Instrumentation)를 사용하는 것입니다. 모니터 드라이버는 밝기 수준을 선택하거나 현재 활성 DPPE 정책에서 선택한 수준으로 밝기 수준을 되돌리기 WMI 밝기 컨트롤을 구현합니다. 밝기 수준을 선택하는 WMI 메서드는 DPPE 정책이 변경될 때까지 현재 DPPE 정책 수준을 재정의합니다. DPPE 정책이 변경되면 새 DPPE 수준이 설정됩니다.
- Windows 2000 디스플레이 드라이버 모델과의 호환성을 위해 모니터 드라이버는 사용자 모드 클라이언트가 밝기를 제어하는 대체 방법으로 IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS 구현합니다. IOCTL_VIDEO_SET_DISPLAY_BRIGHTNESS 대한 호출은 밝기 수준을 선택하는 WMI 밝기 컨트롤과 동일한 방식으로 처리됩니다.
- 모니터 드라이버는 ACPI(고급 구성 및 전원 인터페이스) 드라이버의 밝기 핫키 알림을 현재 밝기 수준을 변경하기 위한 사용자 요청으로 해석합니다. WMI 및 IOCTL 사용자 모드 인터페이스와 마찬가지로 핫 키 알림에 의해 트리거되는 밝기 수준의 변경은 현재 DPPE 정책을 재정의하고 DPPE 정책에서 밝기 값이 다시 설정되도록 요청할 때까지 계속 적용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | dispmprt.h(Dispmprt.h 포함) |
| IRQL | PASSIVE_LEVEL |