Structures

VkDebugUtilsObjectTagInfoEXT

Specify parameters of a tag to attach to an object

The VkDebugUtilsObjectTagInfoEXT structure is defined as:

typedef struct VkDebugUtilsObjectTagInfoEXT {
    VkStructureType sType;
    const void* pNext;
    VkObjectType objectType;
    uint64_t objectHandle;
    uint64_t tagName;
    size_t tagSize;
    const void* pTag;
} VkDebugUtilsObjectTagInfoEXT;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • objectType is a VkObjectType specifying the type of the object to be named.
  • objectHandle is the object to be tagged.
  • tagName is a numerical identifier of the tag.
  • tagSize is the number of bytes of data to attach to the object.
  • pTag is a pointer to an array of tagSize bytes containing the data to be associated with the object.

The tagName parameter gives a name or identifier to the type of data being tagged. This can be used by debugging layers to easily filter for only data that can be used by that implementation.

Valid Usage

VUID-VkDebugUtilsObjectTagInfoEXT-objectType-01908

objectType must not be VK_OBJECT_TYPE_UNKNOWN

VUID-VkDebugUtilsObjectTagInfoEXT-objectHandle-01910

objectHandle must be a valid Vulkan handle of the type associated with objectType as defined in the VkObjectType and Vulkan Handle Relationship table

Valid Usage (Implicit)

VUID-VkDebugUtilsObjectTagInfoEXT-sType-sType

sType must be VK_STRUCTURE_TYPE_DEBUG_UTILS_OBJECT_TAG_INFO_EXT

VUID-VkDebugUtilsObjectTagInfoEXT-pTag-parameter

pTag must be a valid pointer to an array of tagSize bytes