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 将为所有参数（709 原色、2.2 伽玛和 8 nit/颜色分量 RGB 线路格式）还原标准 SDR 值，但不会调用驱动程序，因为这永远不会失败。 相反，驱动程序还应将其显示设备的内部表示形式更新为标准 SDR。

注解

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

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

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

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

要求

要求 值
目标平台 Windows
标头 dispmprt.h