Vulkan-Docs项目中关于vkCmdExecuteCommands命令的VUID描述修正

在Vulkan图形API规范中，关于vkCmdExecuteCommands命令的验证规则VUID-vkCmdExecuteCommands-contents-06018最近被发现存在描述不准确的问题。这个问题涉及到在渲染通道(RenderPass)中使用次级命令缓冲区(Secondary Command Buffers)时的正确配置方式。

问题背景

Vulkan规范中的VUID-vkCmdExecuteCommands-contents-06018原本描述为：如果在由vkCmdBeginRenderPass开始的渲染通道实例中调用vkCmdExecuteCommands，则其contents参数必须设置为VK_SUBPASS_CONTENTS_SECONDARY_COMMAND_BUFFERS或VK_SUBPASS_CONTENTS_INLINE_AND_SECONDARY_COMMAND_BUFFERS_EXT。

然而，这个描述实际上只适用于渲染通道的第一个子通道(subpass)。对于非第一个子通道，contents参数的正确值应该是VK_SUBPASS_CONTENTS_INLINE或VK_SUBPASS_CONTENTS_INLINE_AND_SECONDARY_COMMAND_BUFFERS_EXT。

技术影响

这个错误的VUID描述可能导致开发者产生误解，认为整个渲染通道要么全部使用主命令缓冲区(Primary Command Buffers)，要么全部使用次级命令缓冲区。实际上，Vulkan允许在同一个渲染通道中混合使用这两种方式：

1. 某些子通道可以使用主命令缓冲区
2. 其他子通道可以使用次级命令缓冲区

这种灵活性是Vulkan设计的一个重要特性，允许开发者根据实际需求优化命令缓冲区的使用方式。

修正内容

正确的验证规则应该是：

• 对于子通道0(第一个子通道)，检查vkCmdBeginRenderPass调用时指定的contents参数
• 对于子通道1及后续子通道，检查vkCmdNextSubpass调用时指定的contents参数

这个修正已经在Vulkan 1.3.287规范更新中得到解决，相应的验证层(Vulkan Validation Layers)也进行了同步更新。

开发者建议

开发者在使用次级命令缓冲区时应当注意：

1. 明确每个子通道的命令缓冲区类型需求
2. 在开始渲染通道和切换子通道时正确设置contents参数
3. 理解主命令缓冲区和次级命令缓冲区的不同使用场景和限制
4. 利用混合使用两种命令缓冲区类型的能力来优化性能

这种修正不仅解决了规范描述的不准确问题，也更好地反映了Vulkan API设计的灵活性和强大功能。