VKCMDRESETQUERYPOOL(3)

NAME
vkCmdResetQueryPool - Reset queries in a query pool.

C SPECIFICATION

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

    void vkCmdResetQueryPool(
        VkCommandBuffer                             commandBuffer,
        VkQueryPool                                 queryPool,
        uint32_t                                    firstQuery,
        uint32_t                                    queryCount);

PARAMETERS

    • commandBuffer is the command buffer into which this command will be recorded.

    • 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.

DESCRIPTION

When executed on a queue, this command sets the status of query indices [ $firstQuery,firstQuery+queryCount-1$ ] to unavailable.

VALID USAGE

    • commandBuffer must be a valid VkCommandBuffer handle

    • queryPool must be a valid VkQueryPool handle

    • commandBuffer must be in the recording state

    • The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations

    • This command must only be called outside of a render pass instance

    • Both of commandBuffer, and queryPool must have been created, allocated, or retrieved from the same VkDevice

    • firstQuery must be less than the number of queries in queryPool

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

HOST SYNCHRONIZATION

    • Host access to commandBuffer must be externally synchronized

COMMAND PROPERTIES
Command Buffer Levels | Render Pass Scope | Supported Queue Types
Primary Secondary | Outside | GRAPHICS COMPUTE

SEE ALSO

VkCommandBuffer, VkQueryPool

DOCUMENT NOTES

For more information, see the Vulkan Specification at URL

https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#vkCmdResetQueryPool

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

COPYRIGHT

Copyright (c) 2014-2016 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.

AUTHOR

Khronos Group
    Author.