DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION 콜백 함수(dispmprt.h)

디스플레이 미니포트 드라이버가 통합 디스플레이 패널의 밝기를 제어하는 데 사용하는 최적화 수준을 설정하기 위해 Microsoft DirectX 그래픽 커널 하위 시스템에 의해 호출됩니다.

구문

DXGK_BRIGHTNESS_SET_BACKLIGHT_OPTIMIZATION DxgkBrightnessSetBacklightOptimization;

NTSTATUS DxgkBrightnessSetBacklightOptimization(
  [in] PVOID Context,
  [in] DXGK_BACKLIGHT_OPTIMIZATION_LEVEL OptimizationLevel
)
{...}

매개 변수

[in] Context

디스플레이 어댑터와 연결된 컨텍스트 블록에 대한 핸들입니다. 디스플레이 미니포트 드라이버의 DxgkDdiAddDevice 함수는 이전에 DirectX 그래픽 커널 하위 시스템에 이 핸들을 제공했습니다.

[in] OptimizationLevel

밝기 컨트롤의 최적화 수준을 나타내는 형식 DXGK_BACKLIGHT_OPTIMIZATION_LEVEL 값입니다.

반환 값

성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ntstatus.h에 정의된 오류 코드 중 하나를 반환합니다.

설명

디스플레이 미니포트 드라이버는 화면의 현재 콘텐츠에 따라 통합 디스플레이 패널의 백라이트 최적화 수준을 동적으로 변경할 수 있습니다.

드라이버는 OptimizationLevel 매개 변수에서 백라이트 최적화 수준을 변경하려면 운영 체제의 요청에 응답해야 합니다. 이러한 요청은 시스템 상태 변경을 기반으로 합니다.

드라이버가 DxgkDdiSetBrightnessState 함수에 대한 호출에 대한 응답으로 디스플레이 패널에서 적응 밝기를 사용하도록 설정한 후에는 적응 밝기를 사용하지 않도록 설정해서는 안 됩니다.

드라이버가 백라이트 최적화 수준에서 다른 백라이트로 전환되면 통합 디스플레이 패널의 밝기 설정에서 점진적으로 전환해야 합니다. 이러한 유형의 전환의 중요한 예는 사용자가 비디오 재생 컨트롤을 조정하고 운영 체제가 DxgkBacklightOptimizationDynamic에서 DxgkBacklightOptimizationDesktop으로 OptimizationLevel 값을 다시 설정하여 응답하는 경우입니다.

시스템에 추가 디스플레이 디바이스를 연결해도 드라이버가 통합 디스플레이 패널에서 적응 밝기 제어를 수행할 수 있는 기능이 손상되지 않아야 합니다.

이 함수는 페이지 가능으로 만들어야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	데스크톱
머리글	dispmprt.h(Dispmprt.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

DXGK_BACKLIGHT_OPTIMIZATION_LEVEL

DxgkDdiAddDevice

DxgkDdiSetBrightnessState