DXGK_COLORIMETRY 結構 (d3dkmddi.h)

描述用來描述從顯示裝置擷取之描述項覆寫的色彩測量和密切相關的欄位。

語法

typedef struct _DXGK_COLORIMETRY {
  D3DKMDT_2DOFFSET                   RedPoint;
  D3DKMDT_2DOFFSET                   GreenPoint;
  D3DKMDT_2DOFFSET                   BluePoint;
  D3DKMDT_2DOFFSET                   WhitePoint;
  ULONG                              MinLuminance;
  ULONG                              MaxLuminance;
  ULONG                              MaxFullFrameLuminance;
  D3DKMDT_WIRE_FORMAT_AND_PREFERENCE FormatBitDepths;
  DXGK_STANDARD_COLORIMETRY_FLAGS    StandardColorimetryFlags;
} DXGK_COLORIMETRY, *PDXGK_COLORIMETRY;

成員

RedPoint

覆寫顯示紅色點。 請注意，每個維度都是儲存在最小有效位中的10位值。 零表示沒有覆寫。

GreenPoint

覆寫顯示綠色點。 請注意，每個維度都是儲存在最小有效位中的10位值。

BluePoint

覆寫顯示藍色點。 請注意，每個維度都是儲存在最小有效位中的10位值。

WhitePoint

覆寫顯示白點。 請注意，每個維度都是儲存在最小有效位中的10位值。

MinLuminance

覆寫以 10 萬個 nit 為單位的顯示器所支援的最小亮度值。 只有在 MaxLuminance 為非零時才有效。 零是有效的值。

MaxLuminance

覆寫以 10 萬個 nit 為單位的顯示器所支援的最大亮度值。 此亮度等級預期只支援任何指定畫面格中相對較小的區域。
零表示 MaxLuminance、MaxFullFrameLuminance 或 MinLuminance 沒有覆寫。

MaxFullFrameLuminance

覆寫以 10 萬個 nit 為單位的顯示器所支援的最大全畫面亮度值。 此亮度層級必須同時支持畫面中的每個圖元，才能提供跨畫面顯示可支援的平均亮度值估計值。 只有在 MaxLuminance 為非零時才有效。 零不是有效的覆寫。

FormatBitDepths

覆寫針對線格式所指定之五種色彩編碼方式中每個色彩通道支援的位。 至少必須設定一個位，但不包括保留且必須是零的 [喜好設定] 字段。

StandardColorimetryFlags

指出使用位欄位元元支援特定色彩測量和 EOTF 功能。

備註

此結構同時用於查詢驅動程式的覆寫，以及報告其選取之最後一組值的 OS。 整合式顯示器支援使用內嵌在DXGK_QUERYINTEGRATEDDISPLAYOUT結構內的整合式顯示器，而外部顯示器則會使用這個結構作為輸出緩衝區作為配接器查詢類型的輸出緩衝區DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES。 選取和調整的覆寫會使用 DxgkDdiSetTargetAdjustedColorimetry 回報給驅動程式。

查詢覆寫時，OS 會要求驅動程式填滿所有欄位，或緩衝區會保持零，以避免嘗試從不同來源合併這些相互關聯屬性的複雜性。 如果結構未完全零，OS 會驗證不得為上述的零字段，不是零。

色彩點會進一步驗證超過簡單健全性檢查， (每個值都必須介於 1 到 1023 之間) ，藉由比較每個點的座標與標準點，確保沒有任何值與標準點太遠，以確保合理的值。

當 OS 呼叫 DxgkDdiSetTargetAdjustedColorimetry 時，FormatBitDepths 和 StandardColorimetryFlags 會以零為零，因為這些是功能欄位，因此只有在查詢中才有效。

規格需求

需求	值
標頭	d3dkmddi.h