DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY 콜백 함수(dispmprt.h)

대상에 대해 OS에서 선택한 색 측정값을 보고합니다.

구문

DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY DxgkddiSettargetadjustedcolorimetry;

NTSTATUS DxgkddiSettargetadjustedcolorimetry(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN D3DDDI_VIDEO_PRESENT_TARGET_ID TargetId,
  [in] IN DXGK_COLORIMETRY AdjustedColorimetry
)
{...}

매개 변수

[in] hAdapter

[in] 어댑터를 식별합니다.

[in] TargetId

[in] 디스플레이 어댑터의 비디오 프레젠테이션 대상 식별자입니다.

[in] AdjustedColorimetry

[in] OS가 디스플레이 디바이스 설명자, 모든 재정의 및 조정을 처리한 후 이 대상에 연결된 모니터의 색 측정 관련 필드를 포함하는 DXGK_COLORIMETRY 구조체입니다.

반환 값

드라이버가 제공된 데이터를 기반으로 색 측정 값을 업데이트한 경우 STATUS_SUCCESS 반환합니다.

드라이버가 실패하면 OS는 모든 매개 변수, 709 기본, 2.2 감마 및 색상 구성 요소 RGB 와이어 형식당 8-nit의 표준 SDR 값으로 되돌아가지만 실패하지 않아야 하므로 드라이버를 호출하지 않습니다. 대신 드라이버는 디스플레이 디바이스의 내부 표현을 표준 SDR로 업데이트해야 합니다.

설명

현재 디스플레이 디바이스에 색 측정 관련 매개 변수에 대한 불완전하고 부정확한 설명이 있는 것으로 확인되었으므로 재정의가 필요합니다. 재정의는 드라이버 재정의와 잘못된 매개 변수에 대한 OS 재정의의 두 가지 형식을 사용합니다. 향후 OS 버전에서는 추가 재정의가 구현될 것으로 예상됩니다. OS에서 사용하는 매개 변수와 드라이버를 동기화하기 위해 OS는 각 대상에 대해 DxgkDdiSetTargetAdjustedColorimetry를 호출합니다.

일반적으로 이 호출은 드라이버에서 재정의를 쿼리하고 OS 유효성 검사가 완료된 후 디스플레이가 활성화되기 전에 한 번만 수행됩니다. OS에 다른 형태의 재정의가 있는 경우 디스플레이가 이미 활성화된 후에 도착할 수 있습니다. 이 경우 OS는 두 프레임 내에서 디스플레이 파이프라인에 필요한 업데이트를 수행해야 하는 드라이버를 계속 업데이트합니다. 필요한 경우 드라이버는 변경 사항을 적용하기 위해 디스플레이 출력을 결함으로 전환해야 합니다.

DXGK_COLORIMETRY FormatBitDepths 및 StandardColorimetryFlags는 기능 필드이므로 쿼리에서만 유효하므로 0이 됩니다.

이 함수는 항상 PASSIVE 수준에서 호출되므로 가능한 경우 지원 코드를 페이징 가능으로 만들어야 합니다.

요구 사항

대상 플랫폼	Windows
헤더	dispmprt.h