跳到主要内容

:material-chevron-right-circle: vkAcquireNextImageKHR

函数原型​

VkResult vkAcquireNextImageKHR(
    VkDevice                                    device,
    VkSwapchainKHR                              swapchain,
    uint64_t                                    timeout,
    VkSemaphore                                 semaphore,
    VkFence                                     fence,
    uint32_t*                                   pImageIndex);

描述​

获取下一张可用的显示图像，并返回该图像的索引。

参数​

  • device : 与swapchain关联的逻辑设备。
  • swapchain : 获取图像的交换链。
  • timeout : 没有可用图像时，函数等待的超时时间（单位纳秒）。
  • semaphore : semaphore句柄或者VK_NULL_HANDLE。
  • fence : fence句柄或者VK_NULL_HANDLE。
  • pImageIndex : uint32 t指针，返回下一个可用图像的索引（即在vkGetSwapchainImagesKHR返回的图像数组中的索引）。

返回值​

  • VK_SUCCESS : 成功获取了一张可用的显示图像。
  • 其他 : 获取显示图像失败。