VKCMDRESETQUERYPOOL(3)

NAME
vkCmdResetQueryPool - Reset queries in a query pool.

C SPECIFICATION

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

PARAMETERS

commandBuffer
    The command buffer into which the command is to be placed.

queryPool
    The query pool containing the queries to be reset.

startQuery
    The index of the first query to be reset.

queryCount
    The number of queries to reset.

DESCRIPTION

vkCmdResetQueryPool resets queryCount starting at the entry index given by startQuery in the query pool specified by queryPool. The reset command is executed by the command buffer specified in commandBuffer. After execution, all queries are reset to inactive state and have zero values.

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

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

vkCmdBeginQuery, vkCmdEndQuery, vkCreateQueryPool, vkDestroyQueryPool, vkGetQueryPoolResults, vkCmdCopyQueryPoolResults

COPYRIGHT

Copyright © 2014-2016 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

AUTHOR

Khronos Group
    Author.