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

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

FormatBitDepths

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

StandardColorimetryFlags

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

注解

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

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

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

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

要求

要求 值
Header d3dkmddi.h