> ## 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](/zh-TW/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public) 的便利包裝函式。
因此，以 `SetName` 設定的名稱可以使用相同的 GUID 透過 [ID3D12Object::GetPrivateData](/zh-TW/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](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

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