VkComputeOccupancyPriorityParametersNV(3)

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)

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.