Parameters for defragmentation. More...

#include <vk_mem_alloc.h>

Public Attributes
VmaDefragmentationFlags	flags
	Reserved for future use. Should be 0. More...

uint32_t	allocationCount
	Number of allocations in `pAllocations` array. More...

const VmaAllocation *	pAllocations
	Pointer to array of allocations that can be defragmented. More...

VkBool32 *	pAllocationsChanged
	Optional, output. Pointer to array that will be filled with information whether the allocation at certain index has been changed during defragmentation. More...

uint32_t	poolCount
	Numer of pools in `pPools` array. More...

const VmaPool *	pPools
	Either null or pointer to array of pools to be defragmented. More...

VkDeviceSize	maxCpuBytesToMove
	Maximum total numbers of bytes that can be copied while moving allocations to different places using transfers on CPU side, like `memcpy()`, `memmove()`. More...

uint32_t	maxCpuAllocationsToMove
	Maximum number of allocations that can be moved to a different place using transfers on CPU side, like `memcpy()`, `memmove()`. More...

VkDeviceSize	maxGpuBytesToMove
	Maximum total numbers of bytes that can be copied while moving allocations to different places using transfers on GPU side, posted to `commandBuffer`. More...

uint32_t	maxGpuAllocationsToMove
	Maximum number of allocations that can be moved to a different place using transfers on GPU side, posted to `commandBuffer`. More...

VkCommandBuffer	commandBuffer
	Optional. Command buffer where GPU copy commands will be posted. More...

Detailed Description

Parameters for defragmentation.

To be used with function vmaDefragmentationBegin().

Member Data Documentation

◆ allocationCount

uint32_t VmaDefragmentationInfo2::allocationCount

Number of allocations in pAllocations array.

◆ commandBuffer

VkCommandBuffer VmaDefragmentationInfo2::commandBuffer

Optional. Command buffer where GPU copy commands will be posted.

If not null, it must be a valid command buffer handle that supports Transfer queue type. It must be in the recording state and outside of a render pass instance. You need to submit it and make sure it finished execution before calling vmaDefragmentationEnd().

Passing null means that only CPU defragmentation will be performed.

◆ flags

VmaDefragmentationFlags VmaDefragmentationInfo2::flags

Reserved for future use. Should be 0.

◆ maxCpuAllocationsToMove

uint32_t VmaDefragmentationInfo2::maxCpuAllocationsToMove

Maximum number of allocations that can be moved to a different place using transfers on CPU side, like memcpy(), memmove().

UINT32_MAX means no limit.

◆ maxCpuBytesToMove

VkDeviceSize VmaDefragmentationInfo2::maxCpuBytesToMove

Maximum total numbers of bytes that can be copied while moving allocations to different places using transfers on CPU side, like memcpy(), memmove().

VK_WHOLE_SIZE means no limit.

◆ maxGpuAllocationsToMove

uint32_t VmaDefragmentationInfo2::maxGpuAllocationsToMove

Maximum number of allocations that can be moved to a different place using transfers on GPU side, posted to commandBuffer.

UINT32_MAX means no limit.

◆ maxGpuBytesToMove

VkDeviceSize VmaDefragmentationInfo2::maxGpuBytesToMove

Maximum total numbers of bytes that can be copied while moving allocations to different places using transfers on GPU side, posted to commandBuffer.

VK_WHOLE_SIZE means no limit.

◆ pAllocations

const VmaAllocation* VmaDefragmentationInfo2::pAllocations

Pointer to array of allocations that can be defragmented.

The array should have allocationCount elements. The array should not contain nulls. Elements in the array should be unique - same allocation cannot occur twice. It is safe to pass allocations that are in the lost state - they are ignored. All allocations not present in this array are considered non-moveable during this defragmentation.

◆ pAllocationsChanged

VkBool32* VmaDefragmentationInfo2::pAllocationsChanged

Optional, output. Pointer to array that will be filled with information whether the allocation at certain index has been changed during defragmentation.

The array should have allocationCount elements. You can pass null if you are not interested in this information.

◆ poolCount

uint32_t VmaDefragmentationInfo2::poolCount

Numer of pools in pPools array.

◆ pPools

const VmaPool* VmaDefragmentationInfo2::pPools

Either null or pointer to array of pools to be defragmented.

All the allocations in the specified pools can be moved during defragmentation and there is no way to check if they were really moved as in pAllocationsChanged, so you must query all the allocations in all these pools for new VkDeviceMemory and offset using vmaGetAllocationInfo() if you might need to recreate buffers and images bound to them.

The array should have poolCount elements. The array should not contain nulls. Elements in the array should be unique - same pool cannot occur twice.

Using this array is equivalent to specifying all allocations from the pools in pAllocations. It might be more efficient.

The documentation for this struct was generated from the following file:

vk_mem_alloc.h

Public Attributes