> ## 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/ko/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)에 대한 편의 래퍼입니다.
따라서 `SetName`으로 설정된 이름은 동일한 GUID로 [ID3D12Object::GetPrivateData](https://docs.xbox.com/ko/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/ko/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object.md)


## Related topics

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