VkDispatchParametersARM(3)

# VkDispatchParametersARM(3) Manual Page

## Name

VkDispatchParametersARM - Structure specifying parameters that affect dispatch commands

## C Specification

The `VkDispatchParametersARM` structure is defined as:

    // Provided by VK_ARM_scheduling_controls
    typedef struct VkDispatchParametersARM {
        VkStructureType    sType;
        void*              pNext;
        uint32_t           workGroupBatchSize;
        uint32_t           maxQueuedWorkGroupBatches;
        uint32_t           maxWarpsPerShaderCore;
    } VkDispatchParametersARM;

## Members

- `workGroupBatchSize`, if it is not 0, is the number of workgroups in each batch distributed to shader cores. Otherwise, the implementation selects the number of workgroups in each batch.

- `maxQueuedWorkGroupBatches`, if it is not 0, is the maximum number of workgroup batches that shader cores may queue. Otherwise, the implementation selects the maximum number of workgroup batches that shader cores may queue.

- `maxWarpsPerShaderCore`, if it is not 0, is the maximum number of warps that may run concurrently on individual shader cores. Otherwise, the implementation selects the maximum number of warps that may run concurrently on individual shader cores.

## Description

Valid Usage

- VUID-VkDispatchParametersARM-maxWarpsPerShaderCore-12392
  `maxWarpsPerShaderCore` must be less than or equal to VkPhysicalDeviceSchedulingControlsDispatchParametersPropertiesARM::`schedulingControlsMaxWarpCount`

- VUID-VkDispatchParametersARM-maxQueuedWorkGroupBatches-12393
  `maxQueuedWorkGroupBatches` must be less than or equal to VkPhysicalDeviceSchedulingControlsDispatchParametersPropertiesARM::`schedulingControlsMaxQueuedBatchesCount`

- VUID-VkDispatchParametersARM-workGroupBatchSize-12394
  `workGroupBatchSize` must be less than or equal to VkPhysicalDeviceSchedulingControlsPropertiesARM::`schedulingControlsMaxWorkGroupBatchSize`

Valid Usage (Implicit)

- VUID-VkDispatchParametersARM-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_DISPATCH_PARAMETERS_ARM

- VUID-VkDispatchParametersARM-pNext-pNext
  `pNext` must be `NULL`

## See Also

VK_ARM_scheduling_controls, VkStructureType, vkCmdSetDispatchParametersARM

## 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

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0