Function Prototype

vkCmdSetDispatchParametersARM

Set parameters that affect dispatch commands

To set parameters that affect dispatch commands, call:

void vkCmdSetDispatchParametersARM(
    VkCommandBuffer commandBuffer,
    const VkDispatchParametersARM*    pDispatchParameters);
  • commandBuffer is the command buffer into which the command will be recorded.
  • pDispatchParameters is a pointer to a VkDispatchParametersARM structure specifying the dispatch parameters to be set.

Parameters set using vkCmdSetDispatchParametersARM affect the following dispatch commands:

Valid Usage

VUID-vkCmdSetDispatchParametersARM-schedulingControlsFlags-12391

VkPhysicalDeviceSchedulingControlsPropertiesARM::schedulingControlsFlagsmust contain VK_PHYSICAL_DEVICE_SCHEDULING_CONTROLS_DISPATCH_PARAMETERS_ARM

Valid Usage (Implicit)

VUID-vkCmdSetDispatchParametersARM-pDispatchParameters-parameter

pDispatchParameters must be a valid pointer to a valid VkDispatchParametersARM structure

VUID-vkCmdSetDispatchParametersARM-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_COMPUTE_BIT operations

VUID-vkCmdSetDispatchParametersARM-renderpass

This command must only be called outside of a render pass instance

VUID-vkCmdSetDispatchParametersARM-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