DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION 콜백 함수(dispmprt.h)
통합 디스플레이 패널에 적용되는 백라이트 감소의 현재 수준을 검색합니다.
구문
DXGK_BRIGHTNESS_GET_BACKLIGHT_REDUCTION DxgkBrightnessGetBacklightReduction;
NTSTATUS DxgkBrightnessGetBacklightReduction(
[in] PVOID Context,
[out] DXGK_BACKLIGHT_INFO *BacklightInfo
)
{...}
매개 변수
[in] Context
디스플레이 어댑터와 연결된 DxgkDdiAddDevice 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 함수는 이전에 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.
[out] BacklightInfo
백라이트 감소의 현재 절대 수준을 제공하는 형식 DXGK_BACKLIGHT_INFO 값입니다.
반환 값
성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.
설명
이 함수는 주로 디버깅 및 테스트 목적으로 사용되어 디스플레이 패널에서 고품질의 사용자 환경을 보장합니다. 디스플레이 미니포트 드라이버는 이 함수가 호출될 때 항상 통합 디스플레이 패널에 대한 정확한 정보를 제공해야 합니다.
일부 하드웨어의 경우 BacklightInfo-BacklightUsersetting 또는 BacklightInfo-BacklightEffective>> 의 값이 Windows 밝기 수준 0%에 해당하지 않을 수 있습니다. 따라서 운영 체제에는 BacklightUsersetting 및 BacklightEffective에서 제공하는 절대 밝기 정보가 필요합니다. 하드웨어에서 밝기 수준 0~255를 사용하는 경우 해당 값을 256으로 곱하여 0~65535 범위의 BacklightUsersetting 및 BacklightEffective에 올바르게 매핑해야 합니다.
이 함수는 페이지 가능으로 만들어야 합니다.
컴퓨팅 백라이트 감소 비율
BRR(백라이트 감소 비율)은 (BacklightUsersetting - BacklightEffective) / BacklightUsersetting으로 계산됩니다.운영 체제에서는 새 밝기 수준 요청에 대한 응답으로 드라이버가 BacklightUsersetting / BacklightEffective = 1.0/(1.0 - BRR)의 요소로 픽셀 밝기를 높일 것이라고 가정합니다.
예를 들어 BRR = 0.2인 경우 드라이버는 일반적으로 1.0/(1.0 - BRR) = 1.25의 요소로 밝기를 향상하므로 밝기 값이 255 *(1.0 - BRR) = 204인 픽셀은 포화됩니다. 운영 체제는 드라이버에서 제공하는 BacklightInfo-GammaRamp> 값을 사용하여 특정 이미지의 픽셀 밝기 왜곡을 보다 정확하게 예측할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 지원되는 최소 서버 | Windows Server 2012 |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | dispmprt.h(Dispmprt.h 포함) |
| IRQL | PASSIVE_LEVEL |