Open 3D Engine Atom Gem API Reference
24.09
O3DE is an open-source, fully-featured, high-fidelity, modular 3D engine for building games and simulations, available to every industry.
|
Describes parameter of created VmaPool. More...
#include <vk_mem_alloc.h>
Public Attributes | |
uint32_t | memoryTypeIndex |
Vulkan memory type index to allocate this pool from. | |
VmaPoolCreateFlags | flags |
Use combination of VmaPoolCreateFlagBits. | |
VkDeviceSize | blockSize |
Size of a single VkDeviceMemory block to be allocated as part of this pool, in bytes. Optional. More... | |
size_t | minBlockCount |
Minimum number of blocks to be always allocated in this pool, even if they stay empty. More... | |
size_t | maxBlockCount |
Maximum number of blocks that can be allocated in this pool. Optional. More... | |
float | priority |
A floating-point value between 0 and 1, indicating the priority of the allocations in this pool relative to other memory allocations. More... | |
VkDeviceSize | minAllocationAlignment |
Additional minimum alignment to be used for all allocations created from this pool. Can be 0. More... | |
void *VMA_NULLABLE | pMemoryAllocateNext |
Additional pNext chain to be attached to VkMemoryAllocateInfo used for every allocation made by this pool. Optional. More... | |
Describes parameter of created VmaPool.
VkDeviceSize VmaPoolCreateInfo::blockSize |
Size of a single VkDeviceMemory
block to be allocated as part of this pool, in bytes. Optional.
Specify nonzero to set explicit, constant size of memory blocks used by this pool.
Leave 0 to use default and let the library manage block sizes automatically. Sizes of particular blocks may vary. In this case, the pool will also support dedicated allocations.
size_t VmaPoolCreateInfo::maxBlockCount |
Maximum number of blocks that can be allocated in this pool. Optional.
Set to 0 to use default, which is SIZE_MAX
, which means no limit.
Set to same value as VmaPoolCreateInfo::minBlockCount to have fixed amount of memory allocated throughout whole lifetime of this pool.
VkDeviceSize VmaPoolCreateInfo::minAllocationAlignment |
Additional minimum alignment to be used for all allocations created from this pool. Can be 0.
Leave 0 (default) not to impose any additional alignment. If not 0, it must be a power of two. It can be useful in cases where alignment returned by Vulkan by functions like vkGetBufferMemoryRequirements
is not enough, e.g. when doing interop with OpenGL.
size_t VmaPoolCreateInfo::minBlockCount |
Minimum number of blocks to be always allocated in this pool, even if they stay empty.
Set to 0 to have no preallocated blocks and allow the pool be completely empty.
void* VMA_NULLABLE VmaPoolCreateInfo::pMemoryAllocateNext |
Additional pNext
chain to be attached to VkMemoryAllocateInfo
used for every allocation made by this pool. Optional.
Optional, can be null. If not null, it must point to a pNext
chain of structures that can be attached to VkMemoryAllocateInfo
. It can be useful for special needs such as adding VkExportMemoryAllocateInfoKHR
. Structures pointed by this member must remain alive and unchanged for the whole lifetime of the custom pool.
Please note that some structures, e.g. VkMemoryPriorityAllocateInfoEXT
, VkMemoryDedicatedAllocateInfoKHR
, can be attached automatically by this library when using other, more convenient of its features.
float VmaPoolCreateInfo::priority |
A floating-point value between 0 and 1, indicating the priority of the allocations in this pool relative to other memory allocations.
It is used only when VMA_ALLOCATOR_CREATE_EXT_MEMORY_PRIORITY_BIT flag was used during creation of the VmaAllocator object. Otherwise, this variable is ignored.