DXGKDDI_SETTARGETADJUSTEDCOLORIMETRY回呼函式 （dispmprt.h）

報告作系統針對目標選取的色度值。

語法

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]DXGK_COLORIMETRY結構，包含OS處理顯示裝置描述元、所有覆寫和任何調整之後，附加至此目標之監視器的色彩測量相關欄位。

傳回值

如果驅動程式已根據提供的數據更新其色彩測量值，則驅動程式會傳回STATUS_SUCCESS。

如果驅動程式失敗，OS 會針對所有參數、709 主要、2.2 gamma 和 8-nit 每個色彩元件 RGB 線格式還原為標準 SDR 值，但不會呼叫驅動程式，因為這絕不會失敗。 相反地，驅動程式也應該將其顯示裝置的內部表示法更新為標準 SDR。

言論

由於目前顯示裝置已發現其色彩測量相關參數的描述不完整且不正確，因此需要覆寫。 覆寫採用兩種形式：驅動程式覆寫和無效參數的OS覆寫。 在未來的OS版本中，預期會實作額外的覆寫。 若要讓驅動程式與作系統所使用的參數保持同步，OS 會針對每個目標呼叫 DxgkDdiSetTargetAdjustedColorimetry。

一般而言，只有在驅動程序查詢覆寫並完成 OS 驗證之後，才會進行此呼叫，但在啟動顯示器之前。 當 OS 有其他形式的覆寫時，可能會在顯示器已作用中之後到達。 在此情況下，OS 仍會更新驅動程式，其預期會在兩個畫面格內對其顯示管線進行任何必要的更新。 如有必要，驅動程式應該會故障顯示輸出，以套用變更。

DXGK_COLORIMETRY中的 FormatBitDepths 和 StandardColorimetryFlags 會歸零，因為這些是功能字段，因此在查詢中才有效。

此函式一律會在被動層級呼叫，因此應該盡可能讓支援程式代碼可分頁。

要求

要求	價值
目標平臺	窗戶
標頭	dispmprt.h