vkResetQueryPool
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-None-02665
The hostQueryReset
feature must be
enabled
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-device-parameter
device
must be a valid VkDevice handle
VUID-vkResetQueryPool-queryPool-parameter
queryPool
must be a valid VkQueryPool handle
VUID-vkResetQueryPool-queryPool-parent
queryPool
must have been created, allocated, or retrieved from device