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

> Associa um nome ao objeto de dispositivo. Esse nome é usado em diagnósticos de depuração e ferramentas.

Associa um nome ao objeto de dispositivo.
Esse nome é usado em diagnósticos de depuração e ferramentas.

## Sintaxe

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

### Parâmetros

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

Uma cadeia de caracteres **UNICODE** terminada em **NULL** que contém o nome a ser associado ao objeto de dispositivo.

### Valor retornado

Tipo: HRESULT

Este método retorna um dos [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Este método aceita nomes UNICODE.

Observe que este é simplesmente um wrapper de conveniência em torno de [ID3D12Object::SetPrivateData](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public) com **WKPDID\_D3DDebugObjectNameW**.
Portanto, os nomes definidos com `SetName` podem ser recuperados com [ID3D12Object::GetPrivateData](/pt-BR/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public) com o mesmo GUID.
Além disso, o D3D12 oferece suporte a cadeias de caracteres estreitas para nomes, usando diretamente o GUID **WKPDID\_D3DDebugObjectName**.

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas compatíveis**: consoles XBOX Series e família XBOX One

## Confira também

[Configuração do ambiente de programação do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/directx-12-programming-environment-set-up)

[ID3D12Object](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

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