VulkanHub
Function Prototype

vkSetDebugUtilsObjectNameEXT

Give an application-defined name to an object

An object can be given an application-defined name by calling:

VkResult vkSetDebugUtilsObjectNameEXT(
    VkDevice device,
    const VkDebugUtilsObjectNameInfoEXT* pNameInfo);
  • device is the device that is associated with the named object passed in via objectHandle.
  • pNameInfo is a pointer to a VkDebugUtilsObjectNameInfoEXT structure specifying parameters of the name to set on the object.

Valid Usage

VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-02587

pNameInfo→objectType must not be VK_OBJECT_TYPE_UNKNOWN

VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-02588

pNameInfo→objectHandle must not be VK_NULL_HANDLE

VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-07872

If pNameInfo→objectHandle is the valid handle of an instance-level object, the VkDevice identified by devicemust be a descendent of the same VkInstance as the object identified by pNameInfo→objectHandle

VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-07873

If pNameInfo→objectHandle is the valid handle of a physical-device-level object, the VkDevice identified by device must be a descendant of the same VkPhysicalDevice as the object identified by pNameInfo→objectHandle

VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-07874

If pNameInfo→objectHandle is the valid handle of a device-level object, that object must be a descendent of the VkDevice identified by device

Valid Usage (Implicit)

VUID-vkSetDebugUtilsObjectNameEXT-device-parameter

device must be a valid VkDevice handle

VUID-vkSetDebugUtilsObjectNameEXT-pNameInfo-parameter

pNameInfo must be a valid pointer to a valid VkDebugUtilsObjectNameInfoEXT structure

Host Synchronization

  • Host access to pNameInfo→objectHandle must be externally synchronized ::