VkDebugMarkerObjectNameInfoEXT(3)

Name

VkDebugMarkerObjectNameInfoEXT - Specify parameters of a name to give to an object

C Specification

The VkDebugMarkerObjectNameInfoEXT structure is defined as:

// Provided by VK_EXT_debug_marker
typedef struct VkDebugMarkerObjectNameInfoEXT {
    VkStructureType               sType;
    const void*                   pNext;
    VkDebugReportObjectTypeEXT    objectType;
    uint64_t                      object;
    const char*                   pObjectName;
} VkDebugMarkerObjectNameInfoEXT;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • objectType is a VkDebugReportObjectTypeEXT specifying the type of the object to be named.

  • object is the object to be named.

  • pObjectName is a null-terminated UTF-8 string specifying the name to apply to object.

Description

Applications may change the name associated with an object simply by calling vkDebugMarkerSetObjectNameEXT again with a new string. To remove a previously set name, pObjectName should be an empty string.

Valid Usage
  • VUID-VkDebugMarkerObjectNameInfoEXT-objectType-01490
    objectType must not be VK_DEBUG_REPORT_OBJECT_TYPE_UNKNOWN_EXT

  • VUID-VkDebugMarkerObjectNameInfoEXT-object-01491
    object must not be VK_NULL_HANDLE

  • VUID-VkDebugMarkerObjectNameInfoEXT-object-01492
    object must be a Vulkan object of the type associated with objectType as defined in VkDebugReportObjectTypeEXT and Vulkan Handle Relationship

Valid Usage (Implicit)
  • VUID-VkDebugMarkerObjectNameInfoEXT-sType-sType
    sType must be VK_STRUCTURE_TYPE_DEBUG_MARKER_OBJECT_NAME_INFO_EXT

  • VUID-VkDebugMarkerObjectNameInfoEXT-pNext-pNext
    pNext must be NULL

  • VUID-VkDebugMarkerObjectNameInfoEXT-objectType-parameter
    objectType must be a valid VkDebugReportObjectTypeEXT value

  • VUID-VkDebugMarkerObjectNameInfoEXT-pObjectName-parameter
    pObjectName must be a null-terminated UTF-8 string

Host Synchronization
  • Host access to object must be externally synchronized

Document Notes

For more information, see the Vulkan Specification.

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