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

覆盖以一万分之一的尼特为单位的显示器支持的最小亮度值。 仅当 MaxLuminance 为非零时有效。 零是有效值。

MaxLuminance

覆盖以十万分之一的尼特为单位的显示器支持的最大亮度值。 对于任何给定帧中相对较小的区域，预计支持此亮度级别。
零表示不重写 MaxLuminance、MaxFullFrameLuminance 或 MinLuminance。

MaxFullFrameLuminance

覆盖以十万分之一的 nit 为单位的显示器支持的最大全帧亮度值。 此亮度级别必须同时支持帧中的每个像素，以便提供平均亮度值的估计值，这些值可由整个帧的显示器支持。 仅当 MaxLuminance 为非零时有效。 零不是有效的替代。

FormatBitDepths

在为线路格式指定的五种颜色编码中，覆盖每个颜色通道支持的位。 必须设置至少一位，不包括保留且必须为零的首选项字段。

StandardColorimetryFlags

指示支持使用位字段的特定着色和 EOTF 功能。

言论

此结构既用于从驱动程序查询重写，也用于报告它选择的最终值集的 OS。 此结构嵌入在DXGK_QUERYINTEGRATEDDISPLAYOUT结构中，外部显示用作输出缓冲区的适配器查询类型DXGKQAITYPE_QUERYCOLORIMETRYOVERRIDES，支持集成显示替代。 使用 DxgkDdiSetTargetAdjustedColorimetry 将所选和调整的替代报告回驱动程序。

查询重写时，OS 要求驱动程序填充所有字段或缓冲区都保持零，以避免尝试合并来自不同源的这些相关属性的复杂性。 如果结构未完全为零，则 OS 将验证不能为上述零的字段不是零。

颜色点在简单的健全性检查（每个值必须介于 1 到 1023 之间）之外进一步验证，以便通过将每个点的坐标与标准点的坐标进行比较，并确保没有离标准太远来确保合理的值。

当 OS 调用 DxgkDdiSetTargetAdjustedColorimetry 时，FormatBitDepths 和 StandardColorimetryFlags 为零，因为这些是功能字段，因此仅在查询中有效。

要求

要求	价值
标头	d3dkmddi.h