VkDebugUtilsObjectNameInfoEXT
The VkDebugUtilsObjectNameInfoEXT structure is defined as:
typedef struct VkDebugUtilsObjectNameInfoEXT {
VkStructureType sType;
const void* pNext;
VkObjectType objectType;
uint64_t objectHandle;
const char* pObjectName;
} VkDebugUtilsObjectNameInfoEXT;
sTypeis a VkStructureType value identifying this structure.pNextisNULLor a pointer to a structure extending this structure.objectTypeis a VkObjectType specifying the type of the object to be named.objectHandleis the object to be named.pObjectNameis eitherNULLor 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, 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-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