C Specification

To record an indexed indirect drawing command, call:

// Provided by VK_KHR_device_address_commands
void vkCmdDrawIndexedIndirect2KHR(
    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

vkCmdDrawIndexedIndirect2KHR behaves similarly to vkCmdDrawIndexed 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 VkDrawIndexedIndirectCommand structures.

Valid Usage
  • VUID-vkCmdDrawIndexedIndirect2KHR-None-07312
    If the maintenance6 feature is not enabled, a valid index buffer must be bound

  • VUID-vkCmdDrawIndexedIndirect2KHR-primitiveRestartIndex-12401
    If the primitive restart index for this draw operation was set with vkCmdSetPrimitiveRestartIndexEXT, then primitiveRestartIndex must not be greater than the maximum representable value for the bound VkIndexType

  • VUID-vkCmdDrawIndexedIndirect2KHR-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(VkDrawIndexedIndirectCommand)

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

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

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

  • VUID-vkCmdDrawIndexedIndirect2KHR-commandBuffer-13059
    commandBuffer must not be a protected command buffer

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

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

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

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

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

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

  • VUID-vkCmdDrawIndexedIndirect2KHR-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

vkCmdDrawIndexedIndirect2KHR 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