EVT_IDD_CX_ADAPTER_COMMIT_MODES2回调函数 (iddcx.h)

OS 调用 EVT_IDD_CX_ADAPTER_COMMIT_MODES2 通知驱动程序适配器上的监视器的模式更改。

语法

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

参数

AdapterObject

[in]要查询的适配器的 OS 生成的适配器对象。 在对 iddCxAdapterInitAsync 的上一次调用中返回了此 IDDCX_ADAPTER 对象句柄。

pInArgs

[in]指向包含 EVT_IDD_CX_ADAPTER_COMMIT_MODES2使用的自变量的 IDARG_IN_COMMITMODES2 结构的指针。

返回值

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 返回 NTSTATUS 值。 如果作成功,它将返回STATUS_SUCCESS或其他状态值,NT_SUCCESS(status) 等于 TRUE。 否则,它将返回适当的 NTSTATUS 错误代码。

言论

为监视器提交模式时,将通过此函数调用支持 HDR 或 WCG 的 IddCx 版本 1.10 驱动程序,并告知每个组件的颜色空间和位用于物理监视器连接。 这些值基于驱动程序之前报告的目标功能和模式参数。 报告 FP16 但未公开此函数的 适配器支持是错误的。

在提交的模式下指定的颜色空间不指定交换链中每个图面使用的图面格式。 仍必须查询 IDDCX_METADATA2 中提供的表面。

OS 始终为每个连接的监视器提供 IDDCX_PATH2,即使该监视器未处于活动状态,也指示哪些路径已更改。 如果路径标记为非活动状态,则该路径的整个显示管道将关闭,并且不会向监视器发送任何信号。

提交新路径时,驱动程序应将显示管道编程为显示黑色图像,直到第一帧准备好显示。 为此,WDDM 可见性应处于关闭状态,直到第一帧准备好显示,然后应打开可见性。

有关 HDR 支持的详细信息,请参阅 IddCx 版本 1.10 更新。

要求

要求 价值
最低支持的客户端 Windows 11 版本 22H2 9 月更新(IddCx 版本 1.10)
标头 iddcx.h

另请参阅

IDARG_IN_COMMITMODES2

IDDCX_PATH2

IDDCX_METADATA2