VkComputeOccupancyPriorityParametersNV(3)

# VkComputeOccupancyPriorityParametersNV(3) Manual Page

## Name

VkComputeOccupancyPriorityParametersNV - Structure specifying compute occupancy priority parameters

## C Specification

The `VkComputeOccupancyPriorityParametersNV` structure is defined as:

    // Provided by VK_NV_compute_occupancy_priority
    typedef struct VkComputeOccupancyPriorityParametersNV {
        VkStructureType    sType;
        const void*        pNext;
        float              occupancyPriority;
        float              occupancyThrottling;
    } VkComputeOccupancyPriorityParametersNV;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `occupancyPriority` is a value specifying the occupancy priority for subsequent compute workloads, with a valid range of [0.0, 1.0]. A value of 0.0 represents the lowest priority, while a value of 1.0 is the maximum priority. Default priority is specified by a value of 0.5.

- `occupancyThrottling` is a value specifying the level of occupancy throttling applied to subsequent workloads, with a valid range of [0.0, 1.0]. A value of 0.0 (the default) means no throttling is applied, allowing workloads to use the full available compute capacity. Non-zero values represent increasing levels of throttling, with higher values resulting in more restrictive occupancy limits. A value of 1.0 represents the maximum level of throttling supported by the implementation.

## Description

Valid Usage

- VUID-VkComputeOccupancyPriorityParametersNV-occupancyPriority-12298
  `occupancyPriority` must be between `0` and `1`, inclusive

- VUID-VkComputeOccupancyPriorityParametersNV-occupancyThrottling-12299
  `occupancyThrottling` must be between `0` and `1`, inclusive

Valid Usage (Implicit)

- VUID-VkComputeOccupancyPriorityParametersNV-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_COMPUTE_OCCUPANCY_PRIORITY_PARAMETERS_NV

- VUID-VkComputeOccupancyPriorityParametersNV-pNext-pNext
  `pNext` must be `NULL`

## See Also

VK_NV_compute_occupancy_priority, VkStructureType, vkCmdSetComputeOccupancyPriorityNV

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