vkd3d-proton项目中描述符堆使用问题的分析与修复

问题背景

在vkd3d-proton项目测试过程中，发现test_planar_video_formats测试用例在AMDVLK驱动环境下出现失败。该测试主要用于验证平面视频格式的处理能力，其中涉及无序访问视图(UAV)的清除操作。失败现象表现为ClearUnorderedAccessViewFloat函数提前返回，原因是元数据视图(meta.view)为空指针。

技术分析

经过深入分析，发现问题根源在于测试代码错误地使用了同一个着色器可见(Shader-Visible)描述符堆的CPU和GPU句柄来调用ClearUnorderedAccessView*函数。根据Direct3D 12规范要求，清除无序访问视图操作时，CPU句柄必须来自非着色器可见的描述符堆。

在vkd3d-proton的实现中，当处理着色器可见描述符堆时，CPU虚拟地址的低5位会被清零，这导致d3d12_desc_decode_metadata函数无法正确解析元数据，最终返回空视图指针。这一行为符合Microsoft官方文档对ID3D12GraphicsCommandList::ClearUnorderedAccessViewFloat函数的规范要求。

值得注意的是，不同驱动实现会导致不同的代码路径。例如，RADV驱动支持VKD3D_BINDLESS_MUTABLE_EMBEDDED和VKD3D_BINDLESS_MUTABLE_EMBEDDED_PACKED_METADATA两种标志，而AMDVLK仅支持前者。这解释了为何在RADV环境下不会出现相同问题，因为元数据视图指针不为空。

解决方案

修复方案的核心是创建并使用独立的非着色器可见描述符堆来提供CPU句柄。具体修改包括：

1. 新增一个CPU描述符堆变量srv_uav_cpu_heap
2. 在创建UAV时，同时向GPU可见堆和CPU可见堆写入描述符
3. 在调用清除操作时，使用CPU可见堆的句柄作为CPU参数
4. 确保资源释放时也清理新增的CPU描述符堆

这种修改方式既符合Direct3D 12规范要求，又能保证功能正确性，同时保持了代码的清晰性和可维护性。

类似问题排查

在审查其他测试用例时，发现test_sm68_draw_parameters测试也存在相同的描述符堆使用问题。这表明此类问题可能存在于多个测试场景中，需要进行全面排查和修复。

技术启示

这一问题的解决过程提供了几个重要的技术启示：

1. 必须严格区分着色器可见和非着色器可见描述符堆的使用场景
2. 不同GPU驱动实现可能导致不同的行为表现，测试需要考虑多种环境
3. 核心API的调用参数必须严格遵循官方规范要求
4. 元数据处理机制在不同架构下可能有显著差异

通过这次问题的分析和修复，不仅解决了特定测试用例的失败问题，也加深了对vkd3d-proton描述符管理机制的理解，为未来类似问题的排查提供了宝贵经验。