C Specification

To get an array containing the newest collected latency data, call:

// Provided by VK_NV_low_latency2
void vkGetLatencyTimingsNV(
    VkDevice                                    device,
    VkSwapchainKHR                              swapchain,
    VkGetLatencyMarkerInfoNV*                   pLatencyMarkerInfo);

Parameters

  • device is the device associated with swapchain.

  • swapchain is the swapchain to return data from.

  • pGetLatencyMarkerInfo is a pointer to a VkGetLatencyMarkerInfoNV structure specifying the parameters for returning latency information.

Description

The timings returned by vkGetLatencyTimingsNV contain the timestamps requested from vkSetLatencyMarkerNV and additional implementation-specific markers defined in VkLatencyTimingsFrameReportNV.

Valid Usage (Implicit)

  • VUID-vkGetLatencyTimingsNV-device-parameter
    device must be a valid VkDevice handle

  • VUID-vkGetLatencyTimingsNV-swapchain-parameter
    swapchain must be a valid VkSwapchainKHR handle

  • VUID-vkGetLatencyTimingsNV-pLatencyMarkerInfo-parameter
    pLatencyMarkerInfo must be a valid pointer to a VkGetLatencyMarkerInfoNV structure

  • VUID-vkGetLatencyTimingsNV-swapchain-parent
    swapchain must have been created, allocated, or retrieved from device

See Also

VK_NV_low_latency2, VkDevice, VkGetLatencyMarkerInfoNV, VkSwapchainKHR

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

SPDX-License-Identifier: CC-BY-4.0