C Specification

To record a non-indexed indirect drawing command, call:

// Provided by VK_KHR_device_address_commands
void vkCmdDrawIndirect2KHR(
    VkCommandBuffer                             commandBuffer,
    const VkDrawIndirect2InfoKHR*               pInfo);

Parameters

  • commandBuffer is the command buffer into which the command is recorded.

  • pInfo is a pointer to a VkDrawIndirect2InfoKHR structure defining parameters of this command.

Description

vkCmdDrawIndirect2KHR behaves similarly to vkCmdDraw except that the parameters are read by the device from an address range during execution. pInfo->drawCount draws are executed by the command, with parameters taken from pInfo->addressRange starting at addressRange.address and increasing by addressRange.stride bytes for each successive draw. The parameters of each draw are encoded in an array of VkDrawIndirectCommand structures.

Valid Usage
  • VUID-vkCmdDrawIndirect2KHR-pInfo-13110
    If pInfo->drawCount is greater than 0, pInfo->addressRange.size must be greater than or equal to (pInfo->drawCount - 1) × pInfo->addressRange.stride + sizeof(VkDrawIndirectCommand)

  • VUID-vkCmdDrawIndirect2KHR-pInfo-13111
    If pInfo->drawCount is greater than 1, pInfo->addressRange.stride must not be 0

  • VUID-vkCmdDrawIndirect2KHR-pInfo-13112
    If pInfo->addressRange.stride is not 0, pInfo->addressRange.stride must be greater than or equal to sizeof(VkDrawIndirectCommand)

  • VUID-vkCmdDrawIndirect2KHR-pInfo-13113
    If pInfo->addressRange.stride is not 0, pInfo->addressRange.stride must be a multiple of 4

  • VUID-vkCmdDrawIndirect2KHR-commandBuffer-13057
    commandBuffer must not be a protected command buffer

Valid Usage (Implicit)
  • VUID-vkCmdDrawIndirect2KHR-commandBuffer-parameter
    commandBuffer must be a valid VkCommandBuffer handle

  • VUID-vkCmdDrawIndirect2KHR-pInfo-parameter
    pInfo must be a valid pointer to a valid VkDrawIndirect2InfoKHR structure

  • VUID-vkCmdDrawIndirect2KHR-commandBuffer-recording
    commandBuffer must be in the recording state

  • VUID-vkCmdDrawIndirect2KHR-commandBuffer-cmdpool
    The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_GRAPHICS_BIT operations

  • VUID-vkCmdDrawIndirect2KHR-renderpass
    This command must only be called inside of a render pass instance

  • VUID-vkCmdDrawIndirect2KHR-suspended
    This command must not be called between suspended render pass instances

  • VUID-vkCmdDrawIndirect2KHR-videocoding
    This command must only be called outside of a video coding scope

Host Synchronization
  • Host access to commandBuffer must be externally synchronized

  • Host access to the VkCommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties
Command Buffer Levels Render Pass Scope Video Coding Scope Supported Queue Types Command Type

Primary
Secondary

Inside

Outside

VK_QUEUE_GRAPHICS_BIT

Action

Conditional Rendering

vkCmdDrawIndirect2KHR is affected by conditional rendering

See Also

Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0