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

> Associe un nom à l'objet d'appareil. Ce nom est destiné aux diagnostics de débogage et aux outils.

Associe un nom à l'objet d'appareil.
Ce nom est destiné aux diagnostics de débogage et aux outils.

## Syntaxe

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

### Paramètres

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

Chaîne **UNICODE** terminée par **NULL** qui contient le nom à associer à l'objet d'appareil.

### Valeur renvoyée

Type : HRESULT

Cette méthode renvoie l'un des [codes de retour Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Remarques

Cette méthode accepte des noms UNICODE.

Notez qu'il s'agit simplement d'un wrapper pratique autour de [ID3D12Object::SetPrivateData](/fr/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public) avec **WKPDID\_D3DDebugObjectNameW**.
Par conséquent, les noms définis avec `SetName` peuvent être récupérés avec [ID3D12Object::GetPrivateData](/fr/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public) avec le même GUID.
En outre, D3D12 prend en charge les chaînes étroites pour les noms, en utilisant directement le GUID **WKPDID\_D3DDebugObjectName** à la place.

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge** : consoles XBOX Series et famille XBOX One

## Voir aussi

[Configuration de l'environnement de programmation Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/directx-12-programming-environment-set-up)

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


## Related topics

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