windows显示驱动开发-IddCx 对象

IddCx （间接显示驱动程序类 eXtension） 框架使用可扩展的 UMDF 对象模型来表示间接显示设备的各个组件。 UMDF 对象模型允许将驱动程序特定的存储与每个 IddCx（因此与 UMDF）对象相关联。 有关详细信息，请参阅 UMDF 对象模型。

创建 IDD 对象的顺序为：

驱动程序首先创建 IDDCX_ADAPTER 对象。
然后，驱动程序将创建 一个IDDCX_MONITOR 对象。
创建 IDDCX_ADAPTER 和 IDDCX_MONITOR 对象后，OS 将创建 IDDCX_SWAPCHAIN 并 IDDCX_OPMCTX 对象并将其发送到驱动程序。
以下部分提供了有关这些对象的更多详细信息。

IDDCX_ADAPTER

此对象表示驱动程序在两个阶段过程中创建的单个逻辑显示适配器：

驱动程序调用 IddCxAdapterInitAsync 回调函数。
OS 调用驱动程序的 EvtIddCxAdapterInitFinished DDI 来完成初始化。
IDD 模型没有显式销毁适配器回调。 适配器初始化序列成功完成后，该适配器将保持有效，直到初始化时所连接的 UMDF 设备停止工作。 当间接显示驱动程序（IDD）创建适配器时，它提供有关间接显示适配器的静态适配器信息。

处理多功能设备

最简单的情况是，由附加间接显示设备的即插即用子系统创建的 UMDF 设备对象与 IDD 创建的 IDDCX_ADAPTER 对象之间存在一对一映射。

可能存在更复杂的情况，其中单个间接显示适配器包含多个即插即用设备。 例如，间接显示解决方案可能具有多个 PnP 设备功能，例如麦克风（音频驱动程序）和相机（视频驱动程序）。 在这种情况下，IDD 负责为每个 PnP 设备创建的多个 UMDF 设备对象创建单个 IDDCX_ADAPTER 对象。 驱动程序需要在此方案中考虑以下几点：

仅当成功启动构成间接显示解决方案的所有 PnP 设备后，才应创建 IDDCX_ADAPTER 。
驱动程序在创建适配器时必须传递单个 WDFDEVICE ，因此需要逻辑来决定要传递的 UMDF 设备。
如果构成间接显示适配器的任何设备都存在硬件错误，驱动程序应报告构成适配器的所有设备是否出错。

IDDCX_MONITOR

此对象表示连接到间接显示适配器上某个连接器的特定监视器。

驱动程序在两个阶段过程中创建监视器对象：

它首先调用 IddCxMonitorCreate 回调来创建 IDDCX_MONITOR 对象。
然后，它会调用 IddCxMonitorArrival 回调函数以完成监视器到达。
当监视器断开连接时，驱动程序将调用 IddCxMonitorDeparture 回调来报告此情况。 此调用会导致 IDDCX_MONITOR 对象被销毁。 即使同一监视器被拔出然后重新连接，也需要再次调用 IddCxMonitorDeparture/IddCxMonitorArrival 序列。

IDDCX_MONITOR是IDDCX_ADAPTER对象的子级。

IDDCX_SWAPCHAIN

此对象表示一个 交换链，该交换链 提供在连接的监视器上显示的桌面图像。 交换链具有多个缓冲区，允许OS在IDD访问另一个缓冲区时在一个缓冲区中生成下一个桌面图像。 IDDCX_SWAPCHAIN是IDDCX_MONITOR的子级，因此随时只有一个分配给给定监视器的交换链。

OS 创建并销毁 IDDCX_SWAPCHAIN 对象，并通过调用 EvtIddCxMonitorAssignSwapChain 和 EvtIddCxMonitorUnassignSwapChain 将这些对象分配/取消分配给显示器。

IDDCX_OPMCTX

此对象表示单个应用程序 OPM 上下文中的活动 输出保护管理器 （OPM）上下文，应用程序可用于控制单个监视器上的输出保护。 多个 OPM 上下文可以同时在给定的监视器上处于活动状态。 操作系统调用驱动程序的 EvtIddCxMonitorOPMCreateProtectedOutput 和 EvtIddCxMonitorOPMDestroyProtectedOutput DDI 调用来创建和销毁 OPM 上下文。