org.lwjgl.vulkan

Class EXTHostQueryReset

java.lang.Object

org.lwjgl.vulkan.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

• Requires Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2

Contact

• Bas Nieuwenhuizen BNieuwenhuizen

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 Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	VK_EXT_HOST_QUERY_RESET_EXTENSION_NAME The extension name.
static int	VK_EXT_HOST_QUERY_RESET_SPEC_VERSION The extension specification version.
static int	VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_HOST_QUERY_RESET_FEATURES_EXT Extends VkStructureType.

Method Summary

Modifier and Type	Method and Description
static void	vkResetQueryPoolEXT(org.lwjgl.vulkan.VkDevice device, long queryPool, int firstQuery, int queryCount) Reset queries in a query pool.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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(org.lwjgl.vulkan.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.