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


## Related topics

- [SetPrivateData](/ko/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)
- [XMemSetWin32HeapName](/ko/reference/system/xmem/functions/xmemsetwin32heapname.md)
- [XFrontPanelSetDisplayName](/ko/reference/devkit/xfrontpaneldisplay/functions/xfrontpanelsetdisplayname.md)
- [XtfSetOverlayFolder](/ko/reference/tools/xtf/xtfapi/functions/xtfsetoverlayfolder-xtfapi-xbox-windows-m.md)
- [ObjectSet](/ko/services/playfab/api-references/events/data-types/objectset.md)