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

> デバイス オブジェクトに名前を関連付けます。この名前はデバッグ診断およびツールで使用されます。

デバイス オブジェクトに名前を関連付けます。
この名前はデバッグ診断およびツールで使用されます。

## 構文

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

### パラメーター

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

デバイス オブジェクトに関連付ける名前を含む、**NULL** 終端の **UNICODE** 文字列。

### 戻り値

型: HRESULT

このメソッドは、[Direct3D 12 のリターン コード](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) のいずれかを返します。

## 解説

このメソッドは UNICODE 名を受け取ります。

これは単に、**WKPDID\_D3DDebugObjectNameW** を用いた [ID3D12Object::SetPrivateData](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md) の便利なラッパーであることに注意してください。
そのため、`SetName` で設定した名前は、同じ GUID を用いて [ID3D12Object::GetPrivateData](https://docs.xbox.com/ja-jp/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public.md) で取得できます。
さらに、D3D12 では **WKPDID\_D3DDebugObjectName** GUID を直接使用することで、名前にナロー文字列もサポートしています。

## 要件

**ヘッダー:** d3d12\_xs.h または d3d12\_x.h\
**ライブラリ:** d3d12\_xs.lib または d3d12\_x.lib\
**サポートされているプラットフォーム**: XBOX Series 本体および XBOX One ファミリ

## 関連項目

[Direct3D 12 プログラミング環境のセットアップ](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/directx-12-programming-environment-set-up)

[ID3D12Object](https://docs.xbox.com/ja-jp/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object.md)


## Related topics

- [SetPrivateData](https://docs.xbox.com/ja-jp/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/ja-jp/reference/system/xmem/functions/xmemsetwin32heapname.md)
- [XFrontPanelSetDisplayName](https://docs.xbox.com/ja-jp/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelsetdisplayname.md)
- [PFAccountManagementSetDisplayNameResponse](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementsetdisplaynameresponse.md)