Windows-RS项目中使用DCompositionCreateDevice3接口的注意事项

概述

在使用Windows-RS项目进行DirectComposition开发时，开发者可能会遇到创建DirectComposition设备接口的问题。本文将详细介绍如何正确使用DCompositionCreateDevice3函数以及相关接口的注意事项。

问题现象

在Windows 11 23H2系统上，开发者尝试使用DCompositionCreateDevice3函数创建IDCompositionDevice3接口时，会遇到"不支持此接口(0x80004002)"的错误。然而，使用DCompositionCreateDevice函数却能正常工作。

根本原因

经过分析，这是由于DCompositionCreateDevice3函数对接口标识符(IID)有特定要求导致的。根据微软官方文档，该函数仅支持以下两种接口标识符：

• IDCompositionDevice
• IDCompositionDesktopDevice

正确使用方法

方法一：使用支持的接口

首先获取基础接口，然后通过查询接口方式获取所需的高级接口：

// 首先获取基础设备接口
let device: IDCompositionDevice = DCompositionCreateDevice3(None)?;

// 然后查询转换为IDCompositionDevice3
let device_three: IDCompositionDevice3 = device.cast()?;

方法二：使用IDCompositionDesktopDevice

也可以直接获取桌面设备接口：

let device: IDCompositionDesktopDevice = DCompositionCreateDevice3(None)?;

特殊现象说明

在某些Windows版本中，开发者可能会发现可以直接获取IDCompositionDevice4接口：

let d_comp_device3: IDCompositionDevice4 = DCompositionCreateDevice3(app_manager.dxgi_device())?;

这是因为在内部实现中，DCompositionCreateDevice3函数实际上检查了多个接口标识符，包括IDCompositionDevice4。然而，这种行为并未在官方文档中明确说明，因此不建议在生产环境中依赖这种未文档化的行为，因为它可能在未来的Windows更新中发生变化或被移除。

最佳实践建议

1. 始终遵循官方文档的指导，只使用明确支持的接口标识符
2. 如果需要高级接口，先获取基础接口再查询转换
3. 避免依赖未文档化的行为，确保代码的长期稳定性
4. 在代码中添加适当的错误处理和日志记录，便于问题排查

总结

在Windows-RS项目中使用DirectComposition API时，理解接口层级关系和正确的获取方式至关重要。通过本文介绍的方法，开发者可以避免常见的接口创建错误，编写出更加健壮可靠的DirectComposition应用程序。