> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md) con **WKPDID\_D3DDebugObjectNameW**.
Por lo tanto, los nombres que se establecen con `SetName` se pueden recuperar con [ID3D12Object::GetPrivateData](https://docs.xbox.com/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public.md) 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](https://docs.xbox.com/es/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object.md)


## Related topics

- [SetPrivateData](https://docs.xbox.com/es/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)
- [Set Display Name](https://docs.xbox.com/api-reference/account-management/set-display-name.md)
- [XMemSetWin32HeapName](https://docs.xbox.com/es/reference/system/xmem/functions/xmemsetwin32heapname.md)
- [XFrontPanelSetDisplayName](https://docs.xbox.com/es/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelsetdisplayname.md)
- [PFAccountManagementSetDisplayNameResponse](https://docs.xbox.com/es/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementsetdisplaynameresponse.md)