vkResetQueryPool(3)

Name

vkResetQueryPool - Reset queries in a query pool

C Specification

To reset a range of queries in a query pool on the host, call:

// Provided by VK_VERSION_1_2void vkResetQueryPool(    VkDevice                                    device,    VkQueryPool                                 queryPool,    uint32_t                                    firstQuery,    uint32_t                                    queryCount);

// Provided by VK_EXT_host_query_reset// Equivalent to vkResetQueryPoolvoid vkResetQueryPoolEXT(    VkDevice                                    device,    VkQueryPool                                 queryPool,    uint32_t                                    firstQuery,    uint32_t                                    queryCount);

Parameters

device is the logical device that owns the query pool.
queryPool is the handle of the query pool managing the queriesbeing reset.
firstQuery is the initial query index to reset.
queryCount is the number of queries to reset.

Description

This command sets the status of query indices[firstQuery,firstQuery +queryCount - 1] to unavailable.

IfqueryPool isVK_QUERY_TYPE_PERFORMANCE_QUERY_KHR this commandsets the status of query indices[firstQuery,firstQuery+queryCount - 1] to unavailable for each pass.

Valid Usage

VUID-vkResetQueryPool-firstQuery-09436
firstQuerymust be less than the number of queries inqueryPool
VUID-vkResetQueryPool-firstQuery-09437
The sum offirstQuery andqueryCountmust be less than orequal to the number of queries inqueryPool

VUID-vkResetQueryPool-None-02665
ThehostQueryReset featuremust beenabled
VUID-vkResetQueryPool-firstQuery-02741
Submitted commands that refer to the range specified byfirstQueryandqueryCount inqueryPoolmust have completed execution
VUID-vkResetQueryPool-firstQuery-02742
The range of queries specified byfirstQuery andqueryCountinqueryPoolmust not be in use by calls tovkGetQueryPoolResults orvkResetQueryPool in other threads

Valid Usage (Implicit)

VUID-vkResetQueryPool-device-parameter
devicemust be a validVkDevice handle
VUID-vkResetQueryPool-queryPool-parameter
queryPoolmust be a validVkQueryPool handle
VUID-vkResetQueryPool-queryPool-parent
queryPoolmust have been created, allocated, or retrieved fromdevice

Document Notes

For more information, see theVulkan Specification.

This page is extracted from the Vulkan Specification.Fixes and changes should be made to the Specification, not directly.

Movatterモバイル変換