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

추가 정보

DXGK_BACKLIGHT_INFO

DxgkDdiAddDevice