Class EXTHostQueryReset


  • public class EXTHostQueryReset
    extends java.lang.Object
    This extension adds a new function to reset queries from the host.
    Name String
    VK_EXT_host_query_reset
    Extension Type
    Device extension
    Registered Extension Number
    262
    Revision
    1
    Extension and Version Dependencies
    Contact
    Last Modified Date
    2019-03-06
    IP Status
    No known IP claims.
    Contributors
    • Bas Nieuwenhuizen, Google
    • Jason Ekstrand, Intel
    • Jeff Bolz, NVIDIA
    • Piers Daniell, NVIDIA
    • Field Detail

      • VK_EXT_HOST_QUERY_RESET_SPEC_VERSION

        public static final int VK_EXT_HOST_QUERY_RESET_SPEC_VERSION
        The extension specification version.
        See Also:
        Constant Field Values
      • VK_EXT_HOST_QUERY_RESET_EXTENSION_NAME

        public static final java.lang.String VK_EXT_HOST_QUERY_RESET_EXTENSION_NAME
        The extension name.
        See Also:
        Constant Field Values
      • VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_HOST_QUERY_RESET_FEATURES_EXT

        public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_HOST_QUERY_RESET_FEATURES_EXT
        Extends VkStructureType.
        See Also:
        Constant Field Values
    • Method Detail

      • vkResetQueryPoolEXT

        public static void vkResetQueryPoolEXT​(VkDevice device,
                                               long queryPool,
                                               int firstQuery,
                                               int queryCount)
        Reset queries in a query pool.
        C Specification

        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);
        Description

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

        Valid Usage
        • The hostQueryReset feature must be enabled
        • 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
        • Submitted commands that refer to the range specified by firstQuery and queryCount in queryPool must have completed execution
        • The range of queries specified by firstQuery and queryCount in queryPool must not be in use by calls to GetQueryPoolResults or vkResetQueryPoolEXT in other threads
        Valid Usage (Implicit)
        • device must be a valid VkDevice handle
        • queryPool must be a valid VkQueryPool handle
        • queryPool must have been created, allocated, or retrieved from device
        Parameters:
        device - the logical device that owns the query pool.
        queryPool - the handle of the query pool managing the queries being reset.
        firstQuery - the initial query index to reset.
        queryCount - the number of queries to reset.