vkCmdDrawMeshTasksIndirectCount2EXT(3)

Name

vkCmdDrawMeshTasksIndirectCount2EXT - Perform an indirect mesh tasks draw with the draw count sourced from an address range

C Specification

To record an indirect mesh tasks drawing command with the draw count sourced from an address range, call:

// Provided by VK_KHR_device_address_commands with (VK_KHR_draw_indirect_count or VK_VERSION_1_2) and VK_EXT_mesh_shader
void vkCmdDrawMeshTasksIndirectCount2EXT(
    VkCommandBuffer                             commandBuffer,
    const VkDrawIndirectCount2InfoKHR*          pInfo);

Parameters

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

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

Description

vkCmdDrawMeshTasksIndirectCount2EXT behaves similarly to vkCmdDrawMeshTasksIndirect2EXT except that the draw count is read by the device from an address range during execution. The command will read an unsigned 32-bit integer from pInfo->countAddressRange and use this as the draw count.

Valid Usage
Valid Usage (Implicit)

  • VUID-vkCmdDrawMeshTasksIndirectCount2EXT-commandBuffer-parameter
    commandBuffer must be a valid VkCommandBuffer handle

  • VUID-vkCmdDrawMeshTasksIndirectCount2EXT-pInfo-parameter
    pInfo must be a valid pointer to a valid VkDrawIndirectCount2InfoKHR structure

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

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

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

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

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

vkCmdDrawMeshTasksIndirectCount2EXT is affected by conditional rendering

See Also

VK_EXT_mesh_shader, VK_KHR_device_address_commands, VK_KHR_draw_indirect_count, VK_VERSION_1_2, VkCommandBuffer, VkDrawIndirectCount2InfoKHR

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.