Function Prototype

vkResetQueryPool

Reset queries in a query pool

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

void vkResetQueryPoolEXT(
    VkDevice device,
    VkQueryPool queryPool,
    uint32_t firstQuery,
    uint32_t queryCount);
  • device is the logical device that owns the query pool.
  • queryPool is the handle of the query pool managing the queries being reset.
  • firstQuery is the initial query index to reset.
  • queryCount is the number of queries to reset.

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

If queryPool is VK_QUERY_TYPE_PERFORMANCE_QUERY_KHR this command sets the status of query indices [firstQuery, firstQuery + queryCount - 1] to unavailable for each pass.

Valid Usage

VUID-vkResetQueryPool-firstQuery-09436

firstQuery must be less than the number of queries in queryPool

VUID-vkResetQueryPool-firstQuery-09437

The sum of firstQuery and queryCount must be less than or equal to the number of queries in queryPool

VUID-vkResetQueryPool-firstQuery-02741

Submitted commands that refer to the range specified by firstQuery and queryCount in queryPool must have completed execution

VUID-vkResetQueryPool-firstQuery-02742

The range of queries specified by firstQuery and queryCount in queryPool must not be in use by calls to vkGetQueryPoolResults or vkResetQueryPool in other threads

Valid Usage (Implicit)

VUID-vkResetQueryPool-queryPool-parent

queryPool must have been created, allocated, or retrieved from device