IddCxAdapterSetRenderAdapter 函数 (iddcx.h)

IddCxAdapterSetRenderAdapter 设置要为其呈现指定适配器交换链的首选呈现适配器。

语法

void IddCxAdapterSetRenderAdapter(
  [in] IDDCX_ADAPTER                          AdapterObject,
  [in] const IDARG_IN_ADAPTERSETRENDERADAPTER *pInArgs
);

参数

[in] AdapterObject

为其设置了呈现适配器首选项的适配器的适配器对象。

[in] pInArgs

指向包含函数输入参数的 IDARG_IN_ADAPTERSETRENDERADAPTER 结构的指针。

返回值

没有

言论

间接显示驱动程序(IDD)可以随时调用 IddCxAdapterSetRenderAdapter 以更改首选呈现适配器。 驱动程序可以使用 Dxgi 枚举查找所需的呈现适配器 LUID。

如果可能,OS 将使用 ID 驱动程序的首选呈现适配器。 在某些情况下(例如,首选呈现适配器为 PnpStopped 时),OS 可能会选择其他适配器。 OS 会将用于交换链的实际呈现适配器传递到 EVT_IDD_CX_MONITOR_ASSIGN_SWAPCHAIN 回调中的驱动程序。

可以随时调用 IddCxAdapterSetRenderAdapter 以更改呈现 LUID。 OS 将立即尝试对所有活动监视器使用此新的呈现适配器,并重新创建任何现有的交换链。 当用户重新配置桌面组合时,用户可能会看到一些视觉故障/项目。 为了避免故障,如果驱动程序知道在启动时要使用的呈现适配器,驱动程序应在添加监视器之前调用 IddCxAdapterSetRenderAdapter,并且仅在路径处于活动状态时更改它(例如通过设备配套应用程序)。

控制台和远程 ID 适配器都支持 IddCxAdapterSetRenderAdapter

要求

要求 价值
最低支持的客户端 Windows 10 版本 1903
标头 iddcx.h

另请参阅

IDARG_IN_ADAPTERSETRENDERADAPTER