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