> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetName

> Asocia un nombre al objeto de dispositivo. Este nombre está pensado para su uso en herramientas y diagnósticos de depuración.

Asocia un nombre al objeto de dispositivo.
Este nombre está pensado para su uso en herramientas y diagnósticos de depuración.

## Sintaxis

```cpp theme={null}
HRESULT SetName(
    LPCWSTR Name
)
```

### Parámetros

*Name \[in]*\
Tipo: **LPCWSTR**

Una cadena **UNICODE** terminada en **NULL** que contiene el nombre que se va a asociar al objeto de dispositivo.

### Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los [códigos de retorno de Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentarios

Este método admite nombres UNICODE.

Tenga en cuenta que esto es simplemente un contenedor de conveniencia alrededor de [ID3D12Object::SetPrivateData](/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public) con **WKPDID\_D3DDebugObjectNameW**.
Por lo tanto, los nombres que se establecen con `SetName` se pueden recuperar con [ID3D12Object::GetPrivateData](/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public) con el mismo GUID.
Además, D3D12 admite cadenas estrechas para los nombres, usando directamente el GUID **WKPDID\_D3DDebugObjectName** en su lugar.

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[Configuración del entorno de programación de Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/directx-12-programming-environment-set-up)

[ID3D12Object](/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

- [SetPrivateData](/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)
- [XMemSetWin32HeapName](/es/reference/system/xmem/functions/xmemsetwin32heapname.md)
- [XFrontPanelSetDisplayName](/es/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelsetdisplayname.md)
- [XtfSetOverlayFolder](/es/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [ObjectSet](/es/services/playfab/api-references/events/data-types/objectset.md)