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

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

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

## 構文

```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](/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public) の便利なラッパーであることに注意してください。
そのため、`SetName` で設定した名前は、同じ GUID を用いて [ID3D12Object::GetPrivateData](/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public) で取得できます。
さらに、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](/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)