# vkSetDebugUtilsObjectTagEXT(3) Manual Page

## Name

vkSetDebugUtilsObjectTagEXT - Attach arbitrary data to an object

Loading… please wait.

## C Specification

    // Provided by VK_EXT_debug_utils
    VkResult vkSetDebugUtilsObjectTagEXT(
        VkDevice                                    device,
        const VkDebugUtilsObjectTagInfoEXT*         pTagInfo);

## Parameters

- `device` is the device that created the object.

- `pTagInfo` is a pointer to a VkDebugUtilsObjectTagInfoEXT structure specifying parameters of the tag to attach to the object.

## Description

Valid Usage

- VUID-vkSetDebugUtilsObjectTagEXT-pNameInfo-07875
  If `pNameInfo->objectHandle` is the valid handle of an instance-level object, the VkDevice identified by `device` must be a descendent of the same VkInstance as the object identified by `pNameInfo->objectHandle`

- VUID-vkSetDebugUtilsObjectTagEXT-pNameInfo-07876
  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-vkSetDebugUtilsObjectTagEXT-pNameInfo-07877
  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-vkSetDebugUtilsObjectTagEXT-device-parameter
  `device` must be a valid VkDevice handle

- VUID-vkSetDebugUtilsObjectTagEXT-pTagInfo-parameter
  `pTagInfo` must be a valid pointer to a valid VkDebugUtilsObjectTagInfoEXT structure

Host Synchronization

- Host access to `pTagInfo->objectHandle` must be externally synchronized

Return Codes

On success, this command returns

  - `VK_SUCCESS`

On failure, this command returns

  - `VK_ERROR_OUT_OF_HOST_MEMORY`

  - `VK_ERROR_OUT_OF_DEVICE_MEMORY`

## See Also

VK_EXT_debug_utils, VkDebugUtilsObjectTagInfoEXT, VkDevice

## 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.

## Copyright

Copyright 2014-2024 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0