Function Prototype

vkCreateCommandPool

Create a new command pool object

To create a command pool, call:

VkResult vkCreateCommandPool(
    VkDevice device,
    const VkCommandPoolCreateInfo* pCreateInfo,
    const VkAllocationCallbacks* pAllocator,
    VkCommandPool* pCommandPool);
  • device is the logical device that creates the command pool.
  • pCreateInfo is a pointer to a VkCommandPoolCreateInfo structure specifying the state of the command pool object.
  • pAllocator controls host memory allocation as described in the Memory Allocation chapter.
  • pCommandPool is a pointer to a VkCommandPool handle in which the created pool is returned.

Valid Usage

VUID-vkCreateCommandPool-queueFamilyIndex-01937

pCreateInfo→queueFamilyIndex must be the index of a queue family available in the logical device device

Valid Usage (Implicit)

VUID-vkCreateCommandPool-pCreateInfo-parameter

pCreateInfo must be a valid pointer to a valid VkCommandPoolCreateInfo structure

VUID-vkCreateCommandPool-pAllocator-parameter

If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure

VUID-vkCreateCommandPool-pCommandPool-parameter

pCommandPool must be a valid pointer to a VkCommandPool handle