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 生成的适配器对象。 此 IDDCX_ADAPTER 对象句柄是在之前调用 IddCxAdapterInitAsync 时返回的。

pInArgs

[in]指向 包含EVT_IDD_CX_ADAPTER_COMMIT_MODES2 使用的参数的 IDARG_IN_COMMITMODES2结构的指针。

返回值

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 返回 NTSTATUS 值。 如果操作成功，则返回STATUS_SUCCESS或NT_SUCCESS (状态) 等于 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