C Specification

Present Metering evenly paces out the next numFramesPerBatch vkQueuePresentKHR presents. This gives smoother pacing between presents in applications with frame generation integrations.

The VkSetPresentConfigNV structure is defined as:

// Provided by VK_NV_present_metering
typedef struct VkSetPresentConfigNV {
    VkStructureType    sType;
    const void*        pNext;
    uint32_t           numFramesPerBatch;
    uint32_t           presentConfigFeedback;
} VkSetPresentConfigNV;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • numFramesPerBatch is the number of frames to batch

  • presentConfigFeedback will return the success or error status

Description

The metering configuration applies to all swapchains in the array in VkPresentInfoKHR. The configuration specified by VkSetPresentConfigNV applies to the next numFramesPerBatch calls to vkQueuePresentKHR and needs to be updated every numFramesPerBatch presents.

Valid Usage
  • VUID-VkSetPresentConfigNV-numFramesPerBatch-10581
    numFramesPerBatch must not be larger than 8

Valid Usage (Implicit)
  • VUID-VkSetPresentConfigNV-sType-sType
    sType must be VK_STRUCTURE_TYPE_SET_PRESENT_CONFIG_NV

See Also

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 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0