PCSX2 中的 Vulkan Memory AllocatorVMA从 vk_mem_alloc 头文件到 GS 渲染器的版本演进与实战解读【免费下载链接】pcsx2PCSX2 - The Playstation 2 Emulator项目地址: https://gitcode.com/GitHub_Trending/pc/pcsx2Vulkan 相比 D3D11/OpenGL 在内存管理上复杂得多VkDeviceMemory必须与VkBuffer/VkImage分开分配再手动绑定驱动能力需要查询、不同厂商的内存类型各不相同且系统对内存块数量存在硬性上限。Vulkan Memory AllocatorVMA正是为解决这些问题而生的单头文件 C 库也是 PCSX2 的 Vulkan 图形后端GS管理显存的核心依赖。本文以仓库中 3rdparty/vulkan/include/CHANGELOG.md 为骨架结合 vk_mem_alloc.h 头文件与 pcsx2/GS/Renderers/Vulkan 目录下的真实调用代码梳理 VMA 从 1.0.0 到 3.4.0 的版本演进、关键 API 变迁以及 PCSX2 在后端中如何配置和使用它。读完本文你将掌握 VMA 的核心概念分配器、分配对象、内存类型选择、自定义池、线性/TLSF 算法、碎片整理、虚拟分配器、主要宏与配置项的含义以及一套可直接参考的工程级接入范例。仓库中的 VMA位置与角色在 PCSX2 仓库中VMA 位于3rdparty/vulkan目录下其结构为3rdparty/vulkan/include/vk_mem_alloc.h —— 库的唯一头文件同时包含声明与实现需以VMA_IMPLEMENTATION宏编译一次实现单元3rdparty/vulkan/include/CHANGELOG.md —— 官方变更日志本文主题文档3rdparty/vulkan/include/README.md —— 功能特性与快速上手说明3rdparty/vulkan/CMakeLists.txt —— 以 INTERFACE 库方式导出头文件包含路径3rdparty/vulkan/include/LICENSE.txt 与 3rdparty/vulkan/LICENSE.md —— MIT 许可证。从 CMakeLists.txt 可以看到VMA 以INTERFACE库形式集成仅导出include目录本身不产生编译产物。头文件中当前版本宏为VMA_VERSION (VK_MAKE_VERSION(3, 4, 0))对应 CHANGELOG 中最新的 3.4.0 版本。PCSX2 的 Vulkan GS 渲染器通过 VKLoader.h 预定义宏后包含该头文件#define VMA_STATIC_VULKAN_FUNCTIONS 1 #define VMA_DYNAMIC_VULKAN_FUNCTIONS 0 #define VMA_STATS_STRING_ENABLED 0 #include vk_mem_alloc.h即使用静态 Vulkan 函数绑定、关闭动态加载、并关闭统计字符串生成对应 CHANGELOG 3.0.0 中VMA_STATS_STRING_ENABLED相关的配置体系。实现单元则在 vk_mem_alloc.cpp 中通过#define VMA_IMPLEMENTATION 1单独编译一次。VMA 是什么设计动机与核心能力在深入版本演进之前先明确 VMA 解决的问题依据 README.mdVulkan 需要大量样板代码VkDeviceMemory与VkBuffer/VkImage分开创建后再绑定多了一层间接性必须向驱动查询受支持的内存堆heap与内存类型memory type不同 GPU 厂商差异巨大推荐的做法是分配更大的内存块再把块内区间分配给具体资源因为系统对内存块数量存在上限。VMA 提供的核心能力根据内存预期用途自动选择正确且最优的内存类型用比 Vulkan 标志更高层的语义描述内存的必需/偏好特征分配内存块、把块内未使用区间切分返回给用户VkDeviceMemory offset size内部追踪块内已用/未用区间、为每次分配寻找最佳匹配区间并遵守对齐与 buffer/image 粒度规则一条调用同时完成创建 buffer/image、分配内存并绑定附加能力线程安全内部对同一设备内存块并发访问做同步、映射引用计数、自定义 CPU 内存分配器、非相干内存的 flush/invalidate自动尊重nonCoherentAtomSize、资源别名、稀疏绑定便捷函数、自定义池、线性分配器、Vulkan 1.0~1.4 支持、GPU/CPU 碎片整理、统计信息、JSON dump、外部内存互操作、虚拟分配器等。从 1.0 到 3.4版本演进全景1.0.02017-06-16与 1.0.12017-07-04首次公开发布1.0.1 修复 Linux GCC 编译问题并把 CONFIGURATION SECTION 改为#ifndef包裹允许用户在使用方定义配置宏而不是修改头文件本身。2.0.02018-03-19引入VmaAllocation句柄这是首个大量兼容性破坏的大版本引入的机制至今仍是 VMA 的核心引入VmaAllocation句柄分配函数必须返回它释放时必须连同VkBuffer/VkImage一起传入引入VmaAllocationInfo结构体从中读取VkDeviceMemory与 offset而不再从分配函数直接取支持引用计数的映射与持久映射分配vmaMapMemory、VMA_ALLOCATION_CREATE_MAPPED_BIT支持自定义内存池VmaPool、VmaPoolCreateInfo、vmaCreatePool支持碎片整理vmaDefragment及配套结构支持 lost allocations 特性该特性在 3.0.0 被整体移除。2.1.02018-08-27/09-10线性分配算法与调试增强新增线性分配算法可用于自定义池支持 free-at-once、栈、双栈、环形缓冲区四种形态VMA_POOL_CREATE_LINEAR_ALGORITHM_BIT、VMA_ALLOCATION_CREATE_UPPER_ADDRESS_BIT新增调用序列录制与回放record replayVmaAllocatorCreateInfo::pRecordSettings、VmaReplay 应用该特性在 3.0.0 被移除非相干内存支持增强vmaFlushAllocation、vmaInvalidateAllocation自动尊重nonCoherentAtomSize调试能力VMA_DEBUG_DETECT_CORRUPTION、vmaCheckCorruption、vmaCheckPoolCorruption、VMA_DEBUG_INITIALIZE_ALLOCATIONS、VMA_DEBUG_MARGIN现在块首尾都会加边距。2.2.02018-12-13GPU 碎片整理与 buddy 算法更强大的碎片整理新增VmaDefragmentationInfo2、vmaDefragmentationBegin/vmaDefragmentationEnd支持 GPU 内存整理CPU 内存整理改用memmove可移动重叠区域且对HOST_VISIBLE但非HOST_COHERENT的类型可用需要VmaVulkanFunctions::vkCmdCopyBuffer自定义池可用 buddy 算法VMA_POOL_CREATE_BUDDY_ALGORITHM_BIT该标志在 3.0.0 被移除为稀疏绑定新增批量分配/释放vmaAllocateMemoryPages、vmaFreeMemoryPages新增vmaResizeAllocation原地扩容尝试2.3.0 起废弃3.0.0 移除分配策略标志BEST_FIT / WORST_FIT / FIRST_FIT 及其别名分配大小为 0 的 buffer/image 返回VK_ERROR_VALIDATION_FAILED_EXT。2.3.02019-12-04Vulkan 1.1 与内存预算支持 Vulkan 1.1新增VmaAllocatorCreateInfo::vulkanApiVersion使用 1.1 时无需再启用VK_KHR_dedicated_allocation、VK_KHR_bind_memory2内存预算查询vmaGetBudget、VmaBudget比完整统计更高效配合VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT与VmaAllocatorCreateInfo::instance可从系统查询真实预算否则基于堆大小估算VMA_ALLOCATION_CREATE_WITHIN_BUDGET_BIT使超出预算时分配失败新内存用途VMA_MEMORY_USAGE_CPU_COPY、VMA_MEMORY_USAGE_GPU_LAZILY_ALLOCATEDVK_KHR_bind_memory2支持VMA_ALLOCATION_CREATE_DONT_BIND_BIT、VMA_ALLOCATOR_CREATE_KHR_BIND_MEMORY2_BIT、vmaBindBufferMemory2、vmaBindImageMemory2可指定局部偏移与 pNextvmaSetPoolName/vmaGetPoolName为自定义池命名碎片整理仅对VK_IMAGE_TILING_LINEAR的 buffer/image 合法受实现与 Vulkan 规范限制内部优化VmaAllocation对象从内部自由链表分配器分配使分配/释放平均产生 0 次动态 CPU 堆分配。3.0.02022-03-25API 现代化大版本这是继 2.0.0 之后的又一次大规模变更基础 API 保持向后兼容但删除了一批旧特性新增部分破坏兼容新的内存类型偏好 APIVMA_MEMORY_USAGE_AUTO、VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE、VMA_MEMORY_USAGE_AUTO_PREFER_HOST以及VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT、VMA_ALLOCATION_CREATE_HOST_ACCESS_RANDOM_BIT、VMA_ALLOCATION_CREATE_HOST_ACCESS_ALLOW_TRANSFER_INSTEAD_BIT旧值如VMA_MEMORY_USAGE_GPU_ONLY仍可用但不再推荐全新碎片整理 APIVmaDefragmentationInfo、VmaDefragmentationMove、VmaDefragmentationPassMoveInfo、VmaDefragmentationStats函数vmaBeginDefragmentation/vmaEndDefragmentation/vmaBeginDefragmentationPass/vmaEndDefragmentationPass重新设计的统计 APIVmaStatistics、VmaDetailedStatistics、VmaTotalStatistics、VmaBudget函数vmaGetHeapBudgets、vmaCalculateStatistics、vmaGetPoolStatistics、vmaCalculatePoolStatistics、vmaGetVirtualBlockStatistics、vmaCalculateVirtualBlockStatistics虚拟分配器vmaCreateVirtualBlock/vmaDestroyVirtualBlock等把核心分配算法复用于任意自定义内存如一块大 buffer 内的区间VmaAllocation同时携带void* pUserData与char* pName新增vmaSetAllocationName、VmaAllocationInfo::pNameVMA_ALLOCATION_CREATE_USER_DATA_COPY_STRING_BIT被废弃Vulkan 函数导入方式澄清VMA_STATIC_VULKAN_FUNCTIONS、VMA_DYNAMIC_VULKAN_FUNCTIONS、VmaVulkanFunctions动态模式新增必填的vkGetInstanceProcAddr、vkGetDeviceProcAddr自定义池新特性支持专用分配VmaPoolCreateInfo::pMemoryAllocateNext、minAllocationAlignment支持 Vulkan 1.2、1.3扩展支持VK_KHR_buffer_device_addressVMA_ALLOCATOR_CREATE_BUFFER_DEVICE_ADDRESS_BIT、VK_EXT_memory_prioritypriority成员、VK_AMD_device_coherent_memory、VmaAllocatorCreateInfo::pTypeExternalMemoryHandleTypes新函数vmaGetAllocatorInfo、vmaFlushAllocations/vmaInvalidateAllocations批量、VMA_ALLOCATION_CREATE_CAN_ALIAS_BIT、vmaCreateBufferWithAlignment、vmaGetAllocationMemoryProperties、vmaCreateAliasingBuffer/vmaCreateAliasingImage。移除破坏兼容整个 lost allocations 特性VMA_ALLOCATION_CREATE_CAN_BECOME_LOST_BIT、VMA_ALLOCATION_CREATE_CAN_MAKE_OTHER_LOST_BIT、vmaCreateLostAllocation、vmaMakePoolAllocationsLost、vmaTouchAllocation、frameInUseCount成员整个 record replay 特性pRecordSettings、VmaRecordSettings等VmaReplay 应用一并移除buddy 算法标志VMA_POOL_CREATE_BUDDY_ALGORITHM_BIT策略标志别名STRATEGY_MIN_FRAGMENTATION_BIT、STRATEGY_WORST_FIT_BIT、VIRTUAL_ALLOCATION_CREATE_STRATEGY_MIN_FRAGMENTATION_BITvmaResizeAllocation。算法与工程变化默认分配算法改为 Two-Level Segregated FitTLSF批量释放或bufferImageGranularity较大时明显更快调试宏VMA_DEBUG_ALIGNMENT更名VMA_MIN_ALIGNMENT弃用 Premake、全面改为 CMakevmaInvalidateAllocation/vmaFlushAllocation返回VkResult为 Clang 增加空指针注解VMA_NULLABLE、VMA_NOT_NULL等JSON dump 格式变更。3.1.02024-05-27维护 4/5 与调试宏细化便捷函数vmaCopyMemoryToAllocation、vmaCopyAllocationToMemoryvmaCreateAliasingBuffer2/vmaCreateAliasingImage2在已有分配内创建 buffer/image 并支持allocationLocalOffsetvmaGetAllocationInfo2与VmaAllocationInfo2返回更多分配信息便于与其他 API 互操作碎片整理中断回调VmaDefragmentationInfo::pfnBreakCallback、PFN_vmaCheckDefragmentationBreakFunction、pBreakCallbackUserData可打断长时间运行的vmaBeginDefragmentation扩展支持VK_KHR_maintenance4VMA_ALLOCATOR_CREATE_KHR_MAINTENANCE4_BIT、VK_KHR_maintenance5VMA_ALLOCATOR_CREATE_KHR_MAINTENANCE5_BIT调试/配置宏拆分VMA_DEBUG_LOG与VMA_DEBUG_LOG_FORMAT分离#297新增VMA_ASSERT_LEAK、VMA_LEAK_LOG_FORMAT#379、#385、VMA_EXTENDS_VK_STRUCT#347修复无HOST_CACHED内存类型的 GPU如树莓派上主内存类型选择算法#362以及部分编译器snprintf未声明的 include 问题#312。3.2.02024-12-30/ 3.2.12025-02-05Vulkan 1.4 与外部内存3.2.0支持 Vulkan 1.4支持VK_KHR_external_memory_win32VMA_ALLOCATOR_CREATE_KHR_EXTERNAL_MEMORY_WIN32_BIT、vmaGetMemoryWin32Handle及专门文档章节#442修复线程安全问题#451改进 Cmake 脚本与各类编译器/GPU 兼容性3.2.1修复vmaCreateAllocator在 Vulkan 1.4 下断言错误失败#457修复启用VMA_DYNAMIC_VULKAN_FUNCTIONS时导入vkGetPhysicalDeviceMemoryProperties2/KHR的问题#410。3.3.02025-05-12volk 集成与默认值调整新增vmaImportVulkanFunctionsFromVolk便于配合 volk 库加载 Vulkan 函数指针新增宏VMA_DEBUG_DONT_EXCEED_HEAP_SIZE_WITH_ALLOCATION_SIZE默认值 1VMA_DEBUG_DONT_EXCEED_MAX_MEMORY_ALLOCATION_COUNT默认值由 0 改为 1新增 Frequently asked questions 文档章节。3.4.02026-??-??当前仓库所携带版本新增VmaAllocationCreateInfo::minAlignment#523官方特别提醒结构体务必以零初始化不要依赖特定sizeof以保证向后兼容vmaCreateBufferWithAlignment被标记为废弃其能力可由minAlignment取代外部内存导出/导入改进#503新增vmaCreateDedicatedBuffer、vmaCreateDedicatedImage、vmaAllocateDedicatedMemory均带额外参数void* pMemoryAllocateNext新增vmaGetMemoryWin32Handle2带参数VkExternalMemoryHandleTypeFlagBits handleType新增VMA_VERSION宏携带库版本号#507当前值VK_MAKE_VERSION(3, 4, 0)改进VMA_MEMORY_USAGE_AUTO*的内存类型选择算法#520修复 Clang 21 与 GCC15 下 C20 modules 兼容性#513、#514其他修复与平台/编译器兼容性改进。版本演进中的关键技术主题内存类型选择从显式标志到 AUTO 语义VMA 把 Vulkan 的底层内存属性抽象为更高层的用途描述。3.0.0 之前VMA_MEMORY_USAGE_GPU_ONLY/CPU_ONLY/CPU_TO_GPU/GPU_TO_CPU等枚举直接驱动类型选择且部分枚举保证特定属性如HOST_VISIBLE、HOST_COHERENT。2.3.0 的说明明确指出内部类型选择算法调整后用户不能再假定非显式保证的属性一定存在。3.0.0 引入的VMA_MEMORY_USAGE_AUTO*系列则把必需/偏好语义分离用VMA_ALLOCATION_CREATE_HOST_ACCESS_*标志描述 CPU 访问需求由库在可用内存类型中自动挑选最佳者旧枚举保留兼容但不再推荐。3.4.0 又进一步改进 AUTO 系列的选择算法#520。分配算法线性、buddy 与 TLSF线性算法2.1.0面向一次性释放全部/栈式/环形的短生命周期场景分配成本极低buddy 算法2.2.0面向大块内存的快速拆分与合并但 3.0.0 因维护成本与适用性被移除TLSF3.0.0 起为默认兼顾分配速度与碎片率尤其在批量释放或bufferImageGranularity较大时优势明显。碎片整理的三代演进第一代2.0.0vmaDefragment仅支持 CPU 内存第二代2.2.0vmaDefragmentationBegin/End引入分阶段pass处理并支持 GPU 内存通过vkCmdCopyBuffer同时明确仅VK_IMAGE_TILING_LINEAR合法第三代3.0.0以vmaBeginDefragmentation pass 循环的形态取代旧接口3.1.0 再增加pfnBreakCallback让长时间整理可被安全打断。外部内存互操作从 2.3.0 起支持外部内存类型3.2.0 增加 Windows 平台VK_KHR_external_memory_win32的句柄获取vmaGetMemoryWin32Handle3.4.0 提供vmaGetMemoryWin32Handle2指定句柄类型并新增vmaCreateDedicatedBuffer/Image、vmaAllocateDedicatedMemory携带pMemoryAllocateNext的专用分配入口用于跨 API如与 OpenGL/D3D12 共享场景。实战PCSX2 如何接入与使用 VMA1. 分配器创建与扩展启用PCSX2 在 GSDeviceVK::CreateAllocator 中构建VmaAllocatorCreateInfoVmaAllocatorCreateInfo ci {}; ci.vulkanApiVersion VK_API_VERSION_1_1; // 目标 Vulkan 版本 ci.flags VMA_ALLOCATOR_CREATE_EXTERNALLY_SYNCHRONIZED_BIT; // 由外部单线程同步 ci.physicalDevice m_physical_device; ci.device m_device; ci.instance m_instance; if (m_optional_extensions.vk_ext_memory_budget) ci.flags | VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT; // 真实内存预算查询这段代码印证了 2.3.0 引入的vulkanApiVersion与VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT的用法。它还展示了pHeapSizeLimit的工程用法在 Debug 设备如 RenderDoc 回放下PCSX2 会把小于 512MB 的 DEVICE_LOCAL|HOST_VISIBLE 上传堆 上限设为 0避免 NVIDIA 驱动频繁耗尽显存导致回放困难。分配器句柄保存在m_allocator见 GSDeviceVK.h并通过GetAllocator()提供给各资源类。注意PCSX2 使用VMA_ALLOCATOR_CREATE_EXTERNALLY_SYNCHRONIZED_BIT意味着它承诺在外部自行串行化对分配器的访问VMA 内部不再加锁。2. 纹理Image分配GPU_ONLY 预算控制 专用内存回退GSTextureVK.cpp 展示了纹理分配的核心模式aci.usage VMA_MEMORY_USAGE_GPU_ONLY; aci.flags VMA_ALLOCATION_CREATE_WITHIN_BUDGET_BIT; // 大纹理优先尝试专用内存 aci.flags | VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT; VkResult res vmaCreateImage(allocator, ici, aci, image, allocation, nullptr); if (aci.flags VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT res ! VK_SUCCESS) { aci.flags ~VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT; // 回退取消专用内存再试 res vmaCreateImage(allocator, ici, aci, image, allocation, nullptr); }要点VMA_ALLOCATION_CREATE_WITHIN_BUDGET_BIT2.3.0 引入使分配在超出预算时返回失败而不是压低系统VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT对需要专用分配的图像先尝试专用块失败后回退到常规子分配。3. 可映射纹理与 stagingMAPPED CPU_TO_GPU / GPU_TO_CPU同文件 GSTextureVK.cpp 中可映射纹理使用aci.flags VMA_ALLOCATION_CREATE_MAPPED_BIT; aci.usage VMA_MEMORY_USAGE_CPU_TO_GPU;回读路径GSTextureVK.cpp则使用VMA_MEMORY_USAGE_GPU_TO_CPUVMA_ALLOCATION_CREATE_MAPPED_BIT。MAPPED_BIT2.0.0 引入让分配返回后即为持久映射无需显式vmaMapMemory。在 GSTextureVK.cpp 中回读数据通过vmaInvalidateAllocation使 CPU 侧缓存失效针对非相干内存上传侧则通过vmaFlushAllocation刷新写缓冲GSTextureVK.cpp——这两类函数正是 2.1.0 引入、3.0.0 起返回VkResult的接口。4. 流式上传缓冲持久映射 HOST_COHERENT 偏好VKStreamBuffer.cpp 演示了高性能动态缓冲的经典配方VmaAllocationCreateInfo aci {}; aci.flags VMA_ALLOCATION_CREATE_MAPPED_BIT; aci.usage VMA_MEMORY_USAGE_CPU_TO_GPU; aci.preferredFlags VK_MEMORY_PROPERTY_HOST_COHERENT_BIT; // 偏好相干内存省去手动 flush vmaCreateBuffer(allocator, bci, aci, new_buffer, new_allocation, ai); m_host_pointer static_castu8*(ai.pMappedData); // 直接取映射指针preferredFlags让库在满足必需条件的前提下优先选择HOST_COHERENT类型从而在每帧大量写入时免去逐次vmaFlushAllocation。释放时VKStreamBuffer.cpp调用vmaDestroyBuffer且为避免 GPU 仍在读取时释放PCSX2 提供DeferBufferDestruction机制延迟销毁。5. 预初始化 GPU 缓冲staging 拷贝的完整流程GSDeviceVK::AllocatePreinitializedGPUBuffer 展示了完整的CPU 写 → flush → 拷贝到 GPU链路// 1) CPU staging 缓冲MAPPED CPU_ONLY const VmaAllocationCreateInfo cpu_aci {VMA_ALLOCATION_CREATE_MAPPED_BIT, VMA_MEMORY_USAGE_CPU_ONLY, 0, 0}; vmaCreateBuffer(m_allocator, cpu_bci, cpu_aci, cpu_buffer, cpu_allocation, cpu_ai); // 2) GPU 常驻缓冲GPU_ONLY 偏好 DEVICE_LOCAL const VmaAllocationCreateInfo gpu_aci {0, VMA_MEMORY_USAGE_GPU_ONLY, 0, VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT}; vmaCreateBuffer(m_allocator, gpu_bci, gpu_aci, gpu_buffer, gpu_allocation, ai); // 3) 填充 刷新 拷贝 fill_callback(cpu_ai.pMappedData); vmaFlushAllocation(m_allocator, cpu_allocation, 0, size); vkCmdCopyBuffer(GetCurrentInitCommandBuffer(), cpu_buffer, *gpu_buffer, 1, buf_copy); DeferBufferDestruction(cpu_buffer, cpu_allocation);这里的VmaAllocationCreateInfo初始化顺序为{flags, usage, requiredFlags, preferredFlags}见 GSDeviceVK.cpp 与 GSDeviceVK.cpp四个字段分别对应flags、usage、requiredFlags、preferredFlags。集成与配置要点小结主题关键 API / 宏引入版本分配器创建vmaCreateAllocator、VmaAllocatorCreateInfo1.0.0分配对象与信息VmaAllocation、VmaAllocationInfo、vmaGetAllocationInfo22.0.0 / 3.1.0内存用途语义VMA_MEMORY_USAGE_AUTO*HOST_ACCESS_*3.0.0持久映射VMA_ALLOCATION_CREATE_MAPPED_BIT2.0.0预算控制VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT、WITHIN_BUDGET_BIT、vmaGetBudget2.3.0自定义池VmaPool、vmaCreatePool、线性算法2.0.0 / 2.1.0默认算法TLSF3.0.0碎片整理vmaBeginDefragmentation pass 循环、pfnBreakCallback3.0.0 / 3.1.0虚拟分配器vmaCreateVirtualBlock系列3.0.0外部内存VMA_ALLOCATOR_CREATE_KHR_EXTERNAL_MEMORY_WIN32_BIT、vmaGetMemoryWin32Handle23.2.0 / 3.4.0版本宏VMA_VERSION3.4.0对齐控制minAlignmentvmaCreateBufferWithAlignment已废弃3.4.0工程启示从 CHANGELOG 读出的接入建议结构体零初始化3.4.0 的官方提醒新增成员不破坏二进制兼容的前提是调用方 {}初始化对任何引入新版本 VMA 的项目都适用——PCSX2 代码中所有VmaAllocationCreateInfo aci {};正是这一实践优先使用 AUTO 语义新代码应使用VMA_MEMORY_USAGE_AUTO*与HOST_ACCESS_*标志组合而不是硬编码旧枚举充分利用调试宏VMA_DEBUG_DETECT_CORRUPTION、VMA_DEBUG_INITIALIZE_ALLOCATIONS、VMA_DEBUG_MARGIN、VMA_DEBUG_LOG_FORMAT、VMA_ASSERT_LEAK可帮助排查越界写、未初始化内存与泄漏碎片整理注意边界GPU 碎片整理仅适用于VK_IMAGE_TILING_LINEAR资源且应通过pfnBreakCallback避免单帧卡顿映射内存注意缓存一致性非相干内存必须配对使用vmaFlushAllocation/vmaInvalidateAllocation或利用HOST_COHERENT偏好规避。结语VMA 从 1.0.0 到 3.4.0 的演进本质上是一部Vulkan 内存管理最佳实践的浓缩史从最基本的分配/绑定封装到线性/TLSF 算法、GPU 碎片整理、预算感知、外部内存互操作再到AUTO语义与minAlignment的现代化 API。PCSX2 作为长期使用 Vulkan 后端的开源项目其 GSDeviceVK.cpp、GSTextureVK.cpp、VKStreamBuffer.cpp 中的每一处调用都是对上述演进结论的工程验证。对于想要在自己的 Vulkan 引擎中用好 VMA 的开发者vk_mem_alloc.h 中的 Doxygen 注释是权威参考而本文梳理的版本脉络与 PCSX2 用例则是可以直接落地的路线图。【免费下载链接】pcsx2PCSX2 - The Playstation 2 Emulator项目地址: https://gitcode.com/GitHub_Trending/pc/pcsx2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
PCSX2 中的 Vulkan Memory Allocator（VMA）：从 vk_mem_alloc 头文件到 GS 渲染器的版本演进与实战解读
PCSX2 中的 Vulkan Memory AllocatorVMA从 vk_mem_alloc 头文件到 GS 渲染器的版本演进与实战解读【免费下载链接】pcsx2PCSX2 - The Playstation 2 Emulator项目地址: https://gitcode.com/GitHub_Trending/pc/pcsx2Vulkan 相比 D3D11/OpenGL 在内存管理上复杂得多VkDeviceMemory必须与VkBuffer/VkImage分开分配再手动绑定驱动能力需要查询、不同厂商的内存类型各不相同且系统对内存块数量存在硬性上限。Vulkan Memory AllocatorVMA正是为解决这些问题而生的单头文件 C 库也是 PCSX2 的 Vulkan 图形后端GS管理显存的核心依赖。本文以仓库中 3rdparty/vulkan/include/CHANGELOG.md 为骨架结合 vk_mem_alloc.h 头文件与 pcsx2/GS/Renderers/Vulkan 目录下的真实调用代码梳理 VMA 从 1.0.0 到 3.4.0 的版本演进、关键 API 变迁以及 PCSX2 在后端中如何配置和使用它。读完本文你将掌握 VMA 的核心概念分配器、分配对象、内存类型选择、自定义池、线性/TLSF 算法、碎片整理、虚拟分配器、主要宏与配置项的含义以及一套可直接参考的工程级接入范例。仓库中的 VMA位置与角色在 PCSX2 仓库中VMA 位于3rdparty/vulkan目录下其结构为3rdparty/vulkan/include/vk_mem_alloc.h —— 库的唯一头文件同时包含声明与实现需以VMA_IMPLEMENTATION宏编译一次实现单元3rdparty/vulkan/include/CHANGELOG.md —— 官方变更日志本文主题文档3rdparty/vulkan/include/README.md —— 功能特性与快速上手说明3rdparty/vulkan/CMakeLists.txt —— 以 INTERFACE 库方式导出头文件包含路径3rdparty/vulkan/include/LICENSE.txt 与 3rdparty/vulkan/LICENSE.md —— MIT 许可证。从 CMakeLists.txt 可以看到VMA 以INTERFACE库形式集成仅导出include目录本身不产生编译产物。头文件中当前版本宏为VMA_VERSION (VK_MAKE_VERSION(3, 4, 0))对应 CHANGELOG 中最新的 3.4.0 版本。PCSX2 的 Vulkan GS 渲染器通过 VKLoader.h 预定义宏后包含该头文件#define VMA_STATIC_VULKAN_FUNCTIONS 1 #define VMA_DYNAMIC_VULKAN_FUNCTIONS 0 #define VMA_STATS_STRING_ENABLED 0 #include vk_mem_alloc.h即使用静态 Vulkan 函数绑定、关闭动态加载、并关闭统计字符串生成对应 CHANGELOG 3.0.0 中VMA_STATS_STRING_ENABLED相关的配置体系。实现单元则在 vk_mem_alloc.cpp 中通过#define VMA_IMPLEMENTATION 1单独编译一次。VMA 是什么设计动机与核心能力在深入版本演进之前先明确 VMA 解决的问题依据 README.mdVulkan 需要大量样板代码VkDeviceMemory与VkBuffer/VkImage分开创建后再绑定多了一层间接性必须向驱动查询受支持的内存堆heap与内存类型memory type不同 GPU 厂商差异巨大推荐的做法是分配更大的内存块再把块内区间分配给具体资源因为系统对内存块数量存在上限。VMA 提供的核心能力根据内存预期用途自动选择正确且最优的内存类型用比 Vulkan 标志更高层的语义描述内存的必需/偏好特征分配内存块、把块内未使用区间切分返回给用户VkDeviceMemory offset size内部追踪块内已用/未用区间、为每次分配寻找最佳匹配区间并遵守对齐与 buffer/image 粒度规则一条调用同时完成创建 buffer/image、分配内存并绑定附加能力线程安全内部对同一设备内存块并发访问做同步、映射引用计数、自定义 CPU 内存分配器、非相干内存的 flush/invalidate自动尊重nonCoherentAtomSize、资源别名、稀疏绑定便捷函数、自定义池、线性分配器、Vulkan 1.0~1.4 支持、GPU/CPU 碎片整理、统计信息、JSON dump、外部内存互操作、虚拟分配器等。从 1.0 到 3.4版本演进全景1.0.02017-06-16与 1.0.12017-07-04首次公开发布1.0.1 修复 Linux GCC 编译问题并把 CONFIGURATION SECTION 改为#ifndef包裹允许用户在使用方定义配置宏而不是修改头文件本身。2.0.02018-03-19引入VmaAllocation句柄这是首个大量兼容性破坏的大版本引入的机制至今仍是 VMA 的核心引入VmaAllocation句柄分配函数必须返回它释放时必须连同VkBuffer/VkImage一起传入引入VmaAllocationInfo结构体从中读取VkDeviceMemory与 offset而不再从分配函数直接取支持引用计数的映射与持久映射分配vmaMapMemory、VMA_ALLOCATION_CREATE_MAPPED_BIT支持自定义内存池VmaPool、VmaPoolCreateInfo、vmaCreatePool支持碎片整理vmaDefragment及配套结构支持 lost allocations 特性该特性在 3.0.0 被整体移除。2.1.02018-08-27/09-10线性分配算法与调试增强新增线性分配算法可用于自定义池支持 free-at-once、栈、双栈、环形缓冲区四种形态VMA_POOL_CREATE_LINEAR_ALGORITHM_BIT、VMA_ALLOCATION_CREATE_UPPER_ADDRESS_BIT新增调用序列录制与回放record replayVmaAllocatorCreateInfo::pRecordSettings、VmaReplay 应用该特性在 3.0.0 被移除非相干内存支持增强vmaFlushAllocation、vmaInvalidateAllocation自动尊重nonCoherentAtomSize调试能力VMA_DEBUG_DETECT_CORRUPTION、vmaCheckCorruption、vmaCheckPoolCorruption、VMA_DEBUG_INITIALIZE_ALLOCATIONS、VMA_DEBUG_MARGIN现在块首尾都会加边距。2.2.02018-12-13GPU 碎片整理与 buddy 算法更强大的碎片整理新增VmaDefragmentationInfo2、vmaDefragmentationBegin/vmaDefragmentationEnd支持 GPU 内存整理CPU 内存整理改用memmove可移动重叠区域且对HOST_VISIBLE但非HOST_COHERENT的类型可用需要VmaVulkanFunctions::vkCmdCopyBuffer自定义池可用 buddy 算法VMA_POOL_CREATE_BUDDY_ALGORITHM_BIT该标志在 3.0.0 被移除为稀疏绑定新增批量分配/释放vmaAllocateMemoryPages、vmaFreeMemoryPages新增vmaResizeAllocation原地扩容尝试2.3.0 起废弃3.0.0 移除分配策略标志BEST_FIT / WORST_FIT / FIRST_FIT 及其别名分配大小为 0 的 buffer/image 返回VK_ERROR_VALIDATION_FAILED_EXT。2.3.02019-12-04Vulkan 1.1 与内存预算支持 Vulkan 1.1新增VmaAllocatorCreateInfo::vulkanApiVersion使用 1.1 时无需再启用VK_KHR_dedicated_allocation、VK_KHR_bind_memory2内存预算查询vmaGetBudget、VmaBudget比完整统计更高效配合VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT与VmaAllocatorCreateInfo::instance可从系统查询真实预算否则基于堆大小估算VMA_ALLOCATION_CREATE_WITHIN_BUDGET_BIT使超出预算时分配失败新内存用途VMA_MEMORY_USAGE_CPU_COPY、VMA_MEMORY_USAGE_GPU_LAZILY_ALLOCATEDVK_KHR_bind_memory2支持VMA_ALLOCATION_CREATE_DONT_BIND_BIT、VMA_ALLOCATOR_CREATE_KHR_BIND_MEMORY2_BIT、vmaBindBufferMemory2、vmaBindImageMemory2可指定局部偏移与 pNextvmaSetPoolName/vmaGetPoolName为自定义池命名碎片整理仅对VK_IMAGE_TILING_LINEAR的 buffer/image 合法受实现与 Vulkan 规范限制内部优化VmaAllocation对象从内部自由链表分配器分配使分配/释放平均产生 0 次动态 CPU 堆分配。3.0.02022-03-25API 现代化大版本这是继 2.0.0 之后的又一次大规模变更基础 API 保持向后兼容但删除了一批旧特性新增部分破坏兼容新的内存类型偏好 APIVMA_MEMORY_USAGE_AUTO、VMA_MEMORY_USAGE_AUTO_PREFER_DEVICE、VMA_MEMORY_USAGE_AUTO_PREFER_HOST以及VMA_ALLOCATION_CREATE_HOST_ACCESS_SEQUENTIAL_WRITE_BIT、VMA_ALLOCATION_CREATE_HOST_ACCESS_RANDOM_BIT、VMA_ALLOCATION_CREATE_HOST_ACCESS_ALLOW_TRANSFER_INSTEAD_BIT旧值如VMA_MEMORY_USAGE_GPU_ONLY仍可用但不再推荐全新碎片整理 APIVmaDefragmentationInfo、VmaDefragmentationMove、VmaDefragmentationPassMoveInfo、VmaDefragmentationStats函数vmaBeginDefragmentation/vmaEndDefragmentation/vmaBeginDefragmentationPass/vmaEndDefragmentationPass重新设计的统计 APIVmaStatistics、VmaDetailedStatistics、VmaTotalStatistics、VmaBudget函数vmaGetHeapBudgets、vmaCalculateStatistics、vmaGetPoolStatistics、vmaCalculatePoolStatistics、vmaGetVirtualBlockStatistics、vmaCalculateVirtualBlockStatistics虚拟分配器vmaCreateVirtualBlock/vmaDestroyVirtualBlock等把核心分配算法复用于任意自定义内存如一块大 buffer 内的区间VmaAllocation同时携带void* pUserData与char* pName新增vmaSetAllocationName、VmaAllocationInfo::pNameVMA_ALLOCATION_CREATE_USER_DATA_COPY_STRING_BIT被废弃Vulkan 函数导入方式澄清VMA_STATIC_VULKAN_FUNCTIONS、VMA_DYNAMIC_VULKAN_FUNCTIONS、VmaVulkanFunctions动态模式新增必填的vkGetInstanceProcAddr、vkGetDeviceProcAddr自定义池新特性支持专用分配VmaPoolCreateInfo::pMemoryAllocateNext、minAllocationAlignment支持 Vulkan 1.2、1.3扩展支持VK_KHR_buffer_device_addressVMA_ALLOCATOR_CREATE_BUFFER_DEVICE_ADDRESS_BIT、VK_EXT_memory_prioritypriority成员、VK_AMD_device_coherent_memory、VmaAllocatorCreateInfo::pTypeExternalMemoryHandleTypes新函数vmaGetAllocatorInfo、vmaFlushAllocations/vmaInvalidateAllocations批量、VMA_ALLOCATION_CREATE_CAN_ALIAS_BIT、vmaCreateBufferWithAlignment、vmaGetAllocationMemoryProperties、vmaCreateAliasingBuffer/vmaCreateAliasingImage。移除破坏兼容整个 lost allocations 特性VMA_ALLOCATION_CREATE_CAN_BECOME_LOST_BIT、VMA_ALLOCATION_CREATE_CAN_MAKE_OTHER_LOST_BIT、vmaCreateLostAllocation、vmaMakePoolAllocationsLost、vmaTouchAllocation、frameInUseCount成员整个 record replay 特性pRecordSettings、VmaRecordSettings等VmaReplay 应用一并移除buddy 算法标志VMA_POOL_CREATE_BUDDY_ALGORITHM_BIT策略标志别名STRATEGY_MIN_FRAGMENTATION_BIT、STRATEGY_WORST_FIT_BIT、VIRTUAL_ALLOCATION_CREATE_STRATEGY_MIN_FRAGMENTATION_BITvmaResizeAllocation。算法与工程变化默认分配算法改为 Two-Level Segregated FitTLSF批量释放或bufferImageGranularity较大时明显更快调试宏VMA_DEBUG_ALIGNMENT更名VMA_MIN_ALIGNMENT弃用 Premake、全面改为 CMakevmaInvalidateAllocation/vmaFlushAllocation返回VkResult为 Clang 增加空指针注解VMA_NULLABLE、VMA_NOT_NULL等JSON dump 格式变更。3.1.02024-05-27维护 4/5 与调试宏细化便捷函数vmaCopyMemoryToAllocation、vmaCopyAllocationToMemoryvmaCreateAliasingBuffer2/vmaCreateAliasingImage2在已有分配内创建 buffer/image 并支持allocationLocalOffsetvmaGetAllocationInfo2与VmaAllocationInfo2返回更多分配信息便于与其他 API 互操作碎片整理中断回调VmaDefragmentationInfo::pfnBreakCallback、PFN_vmaCheckDefragmentationBreakFunction、pBreakCallbackUserData可打断长时间运行的vmaBeginDefragmentation扩展支持VK_KHR_maintenance4VMA_ALLOCATOR_CREATE_KHR_MAINTENANCE4_BIT、VK_KHR_maintenance5VMA_ALLOCATOR_CREATE_KHR_MAINTENANCE5_BIT调试/配置宏拆分VMA_DEBUG_LOG与VMA_DEBUG_LOG_FORMAT分离#297新增VMA_ASSERT_LEAK、VMA_LEAK_LOG_FORMAT#379、#385、VMA_EXTENDS_VK_STRUCT#347修复无HOST_CACHED内存类型的 GPU如树莓派上主内存类型选择算法#362以及部分编译器snprintf未声明的 include 问题#312。3.2.02024-12-30/ 3.2.12025-02-05Vulkan 1.4 与外部内存3.2.0支持 Vulkan 1.4支持VK_KHR_external_memory_win32VMA_ALLOCATOR_CREATE_KHR_EXTERNAL_MEMORY_WIN32_BIT、vmaGetMemoryWin32Handle及专门文档章节#442修复线程安全问题#451改进 Cmake 脚本与各类编译器/GPU 兼容性3.2.1修复vmaCreateAllocator在 Vulkan 1.4 下断言错误失败#457修复启用VMA_DYNAMIC_VULKAN_FUNCTIONS时导入vkGetPhysicalDeviceMemoryProperties2/KHR的问题#410。3.3.02025-05-12volk 集成与默认值调整新增vmaImportVulkanFunctionsFromVolk便于配合 volk 库加载 Vulkan 函数指针新增宏VMA_DEBUG_DONT_EXCEED_HEAP_SIZE_WITH_ALLOCATION_SIZE默认值 1VMA_DEBUG_DONT_EXCEED_MAX_MEMORY_ALLOCATION_COUNT默认值由 0 改为 1新增 Frequently asked questions 文档章节。3.4.02026-??-??当前仓库所携带版本新增VmaAllocationCreateInfo::minAlignment#523官方特别提醒结构体务必以零初始化不要依赖特定sizeof以保证向后兼容vmaCreateBufferWithAlignment被标记为废弃其能力可由minAlignment取代外部内存导出/导入改进#503新增vmaCreateDedicatedBuffer、vmaCreateDedicatedImage、vmaAllocateDedicatedMemory均带额外参数void* pMemoryAllocateNext新增vmaGetMemoryWin32Handle2带参数VkExternalMemoryHandleTypeFlagBits handleType新增VMA_VERSION宏携带库版本号#507当前值VK_MAKE_VERSION(3, 4, 0)改进VMA_MEMORY_USAGE_AUTO*的内存类型选择算法#520修复 Clang 21 与 GCC15 下 C20 modules 兼容性#513、#514其他修复与平台/编译器兼容性改进。版本演进中的关键技术主题内存类型选择从显式标志到 AUTO 语义VMA 把 Vulkan 的底层内存属性抽象为更高层的用途描述。3.0.0 之前VMA_MEMORY_USAGE_GPU_ONLY/CPU_ONLY/CPU_TO_GPU/GPU_TO_CPU等枚举直接驱动类型选择且部分枚举保证特定属性如HOST_VISIBLE、HOST_COHERENT。2.3.0 的说明明确指出内部类型选择算法调整后用户不能再假定非显式保证的属性一定存在。3.0.0 引入的VMA_MEMORY_USAGE_AUTO*系列则把必需/偏好语义分离用VMA_ALLOCATION_CREATE_HOST_ACCESS_*标志描述 CPU 访问需求由库在可用内存类型中自动挑选最佳者旧枚举保留兼容但不再推荐。3.4.0 又进一步改进 AUTO 系列的选择算法#520。分配算法线性、buddy 与 TLSF线性算法2.1.0面向一次性释放全部/栈式/环形的短生命周期场景分配成本极低buddy 算法2.2.0面向大块内存的快速拆分与合并但 3.0.0 因维护成本与适用性被移除TLSF3.0.0 起为默认兼顾分配速度与碎片率尤其在批量释放或bufferImageGranularity较大时优势明显。碎片整理的三代演进第一代2.0.0vmaDefragment仅支持 CPU 内存第二代2.2.0vmaDefragmentationBegin/End引入分阶段pass处理并支持 GPU 内存通过vkCmdCopyBuffer同时明确仅VK_IMAGE_TILING_LINEAR合法第三代3.0.0以vmaBeginDefragmentation pass 循环的形态取代旧接口3.1.0 再增加pfnBreakCallback让长时间整理可被安全打断。外部内存互操作从 2.3.0 起支持外部内存类型3.2.0 增加 Windows 平台VK_KHR_external_memory_win32的句柄获取vmaGetMemoryWin32Handle3.4.0 提供vmaGetMemoryWin32Handle2指定句柄类型并新增vmaCreateDedicatedBuffer/Image、vmaAllocateDedicatedMemory携带pMemoryAllocateNext的专用分配入口用于跨 API如与 OpenGL/D3D12 共享场景。实战PCSX2 如何接入与使用 VMA1. 分配器创建与扩展启用PCSX2 在 GSDeviceVK::CreateAllocator 中构建VmaAllocatorCreateInfoVmaAllocatorCreateInfo ci {}; ci.vulkanApiVersion VK_API_VERSION_1_1; // 目标 Vulkan 版本 ci.flags VMA_ALLOCATOR_CREATE_EXTERNALLY_SYNCHRONIZED_BIT; // 由外部单线程同步 ci.physicalDevice m_physical_device; ci.device m_device; ci.instance m_instance; if (m_optional_extensions.vk_ext_memory_budget) ci.flags | VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT; // 真实内存预算查询这段代码印证了 2.3.0 引入的vulkanApiVersion与VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT的用法。它还展示了pHeapSizeLimit的工程用法在 Debug 设备如 RenderDoc 回放下PCSX2 会把小于 512MB 的 DEVICE_LOCAL|HOST_VISIBLE 上传堆 上限设为 0避免 NVIDIA 驱动频繁耗尽显存导致回放困难。分配器句柄保存在m_allocator见 GSDeviceVK.h并通过GetAllocator()提供给各资源类。注意PCSX2 使用VMA_ALLOCATOR_CREATE_EXTERNALLY_SYNCHRONIZED_BIT意味着它承诺在外部自行串行化对分配器的访问VMA 内部不再加锁。2. 纹理Image分配GPU_ONLY 预算控制 专用内存回退GSTextureVK.cpp 展示了纹理分配的核心模式aci.usage VMA_MEMORY_USAGE_GPU_ONLY; aci.flags VMA_ALLOCATION_CREATE_WITHIN_BUDGET_BIT; // 大纹理优先尝试专用内存 aci.flags | VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT; VkResult res vmaCreateImage(allocator, ici, aci, image, allocation, nullptr); if (aci.flags VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT res ! VK_SUCCESS) { aci.flags ~VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT; // 回退取消专用内存再试 res vmaCreateImage(allocator, ici, aci, image, allocation, nullptr); }要点VMA_ALLOCATION_CREATE_WITHIN_BUDGET_BIT2.3.0 引入使分配在超出预算时返回失败而不是压低系统VMA_ALLOCATION_CREATE_DEDICATED_MEMORY_BIT对需要专用分配的图像先尝试专用块失败后回退到常规子分配。3. 可映射纹理与 stagingMAPPED CPU_TO_GPU / GPU_TO_CPU同文件 GSTextureVK.cpp 中可映射纹理使用aci.flags VMA_ALLOCATION_CREATE_MAPPED_BIT; aci.usage VMA_MEMORY_USAGE_CPU_TO_GPU;回读路径GSTextureVK.cpp则使用VMA_MEMORY_USAGE_GPU_TO_CPUVMA_ALLOCATION_CREATE_MAPPED_BIT。MAPPED_BIT2.0.0 引入让分配返回后即为持久映射无需显式vmaMapMemory。在 GSTextureVK.cpp 中回读数据通过vmaInvalidateAllocation使 CPU 侧缓存失效针对非相干内存上传侧则通过vmaFlushAllocation刷新写缓冲GSTextureVK.cpp——这两类函数正是 2.1.0 引入、3.0.0 起返回VkResult的接口。4. 流式上传缓冲持久映射 HOST_COHERENT 偏好VKStreamBuffer.cpp 演示了高性能动态缓冲的经典配方VmaAllocationCreateInfo aci {}; aci.flags VMA_ALLOCATION_CREATE_MAPPED_BIT; aci.usage VMA_MEMORY_USAGE_CPU_TO_GPU; aci.preferredFlags VK_MEMORY_PROPERTY_HOST_COHERENT_BIT; // 偏好相干内存省去手动 flush vmaCreateBuffer(allocator, bci, aci, new_buffer, new_allocation, ai); m_host_pointer static_castu8*(ai.pMappedData); // 直接取映射指针preferredFlags让库在满足必需条件的前提下优先选择HOST_COHERENT类型从而在每帧大量写入时免去逐次vmaFlushAllocation。释放时VKStreamBuffer.cpp调用vmaDestroyBuffer且为避免 GPU 仍在读取时释放PCSX2 提供DeferBufferDestruction机制延迟销毁。5. 预初始化 GPU 缓冲staging 拷贝的完整流程GSDeviceVK::AllocatePreinitializedGPUBuffer 展示了完整的CPU 写 → flush → 拷贝到 GPU链路// 1) CPU staging 缓冲MAPPED CPU_ONLY const VmaAllocationCreateInfo cpu_aci {VMA_ALLOCATION_CREATE_MAPPED_BIT, VMA_MEMORY_USAGE_CPU_ONLY, 0, 0}; vmaCreateBuffer(m_allocator, cpu_bci, cpu_aci, cpu_buffer, cpu_allocation, cpu_ai); // 2) GPU 常驻缓冲GPU_ONLY 偏好 DEVICE_LOCAL const VmaAllocationCreateInfo gpu_aci {0, VMA_MEMORY_USAGE_GPU_ONLY, 0, VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT}; vmaCreateBuffer(m_allocator, gpu_bci, gpu_aci, gpu_buffer, gpu_allocation, ai); // 3) 填充 刷新 拷贝 fill_callback(cpu_ai.pMappedData); vmaFlushAllocation(m_allocator, cpu_allocation, 0, size); vkCmdCopyBuffer(GetCurrentInitCommandBuffer(), cpu_buffer, *gpu_buffer, 1, buf_copy); DeferBufferDestruction(cpu_buffer, cpu_allocation);这里的VmaAllocationCreateInfo初始化顺序为{flags, usage, requiredFlags, preferredFlags}见 GSDeviceVK.cpp 与 GSDeviceVK.cpp四个字段分别对应flags、usage、requiredFlags、preferredFlags。集成与配置要点小结主题关键 API / 宏引入版本分配器创建vmaCreateAllocator、VmaAllocatorCreateInfo1.0.0分配对象与信息VmaAllocation、VmaAllocationInfo、vmaGetAllocationInfo22.0.0 / 3.1.0内存用途语义VMA_MEMORY_USAGE_AUTO*HOST_ACCESS_*3.0.0持久映射VMA_ALLOCATION_CREATE_MAPPED_BIT2.0.0预算控制VMA_ALLOCATOR_CREATE_EXT_MEMORY_BUDGET_BIT、WITHIN_BUDGET_BIT、vmaGetBudget2.3.0自定义池VmaPool、vmaCreatePool、线性算法2.0.0 / 2.1.0默认算法TLSF3.0.0碎片整理vmaBeginDefragmentation pass 循环、pfnBreakCallback3.0.0 / 3.1.0虚拟分配器vmaCreateVirtualBlock系列3.0.0外部内存VMA_ALLOCATOR_CREATE_KHR_EXTERNAL_MEMORY_WIN32_BIT、vmaGetMemoryWin32Handle23.2.0 / 3.4.0版本宏VMA_VERSION3.4.0对齐控制minAlignmentvmaCreateBufferWithAlignment已废弃3.4.0工程启示从 CHANGELOG 读出的接入建议结构体零初始化3.4.0 的官方提醒新增成员不破坏二进制兼容的前提是调用方 {}初始化对任何引入新版本 VMA 的项目都适用——PCSX2 代码中所有VmaAllocationCreateInfo aci {};正是这一实践优先使用 AUTO 语义新代码应使用VMA_MEMORY_USAGE_AUTO*与HOST_ACCESS_*标志组合而不是硬编码旧枚举充分利用调试宏VMA_DEBUG_DETECT_CORRUPTION、VMA_DEBUG_INITIALIZE_ALLOCATIONS、VMA_DEBUG_MARGIN、VMA_DEBUG_LOG_FORMAT、VMA_ASSERT_LEAK可帮助排查越界写、未初始化内存与泄漏碎片整理注意边界GPU 碎片整理仅适用于VK_IMAGE_TILING_LINEAR资源且应通过pfnBreakCallback避免单帧卡顿映射内存注意缓存一致性非相干内存必须配对使用vmaFlushAllocation/vmaInvalidateAllocation或利用HOST_COHERENT偏好规避。结语VMA 从 1.0.0 到 3.4.0 的演进本质上是一部Vulkan 内存管理最佳实践的浓缩史从最基本的分配/绑定封装到线性/TLSF 算法、GPU 碎片整理、预算感知、外部内存互操作再到AUTO语义与minAlignment的现代化 API。PCSX2 作为长期使用 Vulkan 后端的开源项目其 GSDeviceVK.cpp、GSTextureVK.cpp、VKStreamBuffer.cpp 中的每一处调用都是对上述演进结论的工程验证。对于想要在自己的 Vulkan 引擎中用好 VMA 的开发者vk_mem_alloc.h 中的 Doxygen 注释是权威参考而本文梳理的版本脉络与 PCSX2 用例则是可以直接落地的路线图。【免费下载链接】pcsx2PCSX2 - The Playstation 2 Emulator项目地址: https://gitcode.com/GitHub_Trending/pc/pcsx2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
