VkDebugUtilsObjectNameInfoEXT
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
isNULL
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 eitherNULL
or a null-terminated UTF-8 string specifying the name to apply toobjectHandle
.
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
, objectHandle
must 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-objectType-parameter
objectType
must be a valid VkObjectType value
VUID-VkDebugUtilsObjectNameInfoEXT-pObjectName-parameter
If pObjectName
is not NULL
, pObjectName
must be a null-terminated UTF-8 string