Structures

VkDebugUtilsObjectNameInfoEXT

Specify parameters of a name to give to an object

The VkDebugUtilsObjectNameInfoEXT structure is defined as:

typedef struct VkDebugUtilsObjectNameInfoEXT {
    VkStructureType sType;
    const void* pNext;
    VkObjectType objectType;
    uint64_t objectHandle;
    const char* pObjectName;
} VkDebugUtilsObjectNameInfoEXT;
  • 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 named.
  • pObjectName is either NULL or a null-terminated UTF-8 string specifying the name to apply to objectHandle.

Applications may change the name associated with an object simply by calling vkSetDebugUtilsObjectNameEXT again with a new string. If pObjectName is either NULL or an empty string, then any previously set name is removed.

The graphicsPipelineLibrary feature allows the specification of pipelines without the creation of VkShaderModule objects beforehand. In order to continue to allow naming these shaders independently, VkDebugUtilsObjectNameInfoEXT can be included in the pNext chain of VkPipelineShaderStageCreateInfo, which associates a static name with that particular shader.

Valid Usage

VUID-VkDebugUtilsObjectNameInfoEXT-objectType-02589

If objectType is VK_OBJECT_TYPE_UNKNOWN, objectHandlemust not be VK_NULL_HANDLE

VUID-VkDebugUtilsObjectNameInfoEXT-objectType-02590

If objectType is not VK_OBJECT_TYPE_UNKNOWN, objectHandle must be VK_NULL_HANDLE or a valid Vulkan handle of the type associated with objectType as defined in the VkObjectType and Vulkan Handle Relationship table

Valid Usage (Implicit)

VUID-VkDebugUtilsObjectNameInfoEXT-sType-sType

sType must be VK_STRUCTURE_TYPE_DEBUG_UTILS_OBJECT_NAME_INFO_EXT

VUID-VkDebugUtilsObjectNameInfoEXT-pObjectName-parameter

If pObjectName is not NULL, pObjectName must be a null-terminated UTF-8 string