通过

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 将还原到所有参数的标准 SDR 值，709 初选、2.2 伽玛和 8 尼特/色组件 RGB 线路格式，但它不会调用驱动程序，因为这绝不会失败。 相反，驱动程序还应将显示设备的内部表示形式更新为标准 SDR。

言论

由于发现当前显示设备对其着色相关参数的描述不完整和不准确，因此需要替代。 替代采用两种形式：驱动程序替代和 OS 替代无效参数。 在未来的 OS 版本中，预期将实现其他替代。 若要使驱动程序与作系统所使用的参数保持同步，OS 将为每个目标调用 DxgkDdiSetTargetAdjustedColorimetry。

通常，只有在查询驱动程序进行替代和 OS 验证完成之后，才会进行此调用，但在激活显示之前。 当 OS 具有其他形式的替代时，在显示已处于活动状态后，它们可能会到达。 在这种情况下，OS 仍将更新驱动程序，该驱动程序预期会在两个帧内对其显示管道进行任何必要的更新。 如有必要，驱动程序应故障显示输出以应用更改。

DXGK_COLORIMETRY中的 FormatBitDepths 和 StandardColorimetryFlags 为零，因为这些是功能字段，因此仅在查询中有效。

此函数始终在 PASSIVE 级别调用，因此应尽可能使支持代码可分页。

要求

要求 价值
目标平台 窗户
标头 dispmprt.h