Structures

VkComputeOccupancyPriorityParametersNV

Structure specifying compute occupancy priority parameters

The VkComputeOccupancyPriorityParametersNV structure is defined as:

typedef struct VkComputeOccupancyPriorityParametersNV {
    VkStructureType sType;
    const void* pNext;
    float occupancyPriority;
    float occupancyThrottling;
} VkComputeOccupancyPriorityParametersNV;
  • 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.

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