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

傳回值

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

如果驅動程序失敗，OS 會還原為所有參數的標準 SDR 值，709 主要復本、2.2 gamma 和 8 nit，但不會呼叫驅動程式，因為這應該永遠不會失敗。 相反地，驅動程式也應該將其顯示裝置的內部表示法更新為標準 SDR。

備註

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

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

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

此函式一律會在 PASSIVE 層級呼叫，因此應該盡可能將支援程式代碼設為可分頁。

規格需求