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

# SetPrivateData

> 장치 개체에 애플리케이션 정의 데이터를 설정하고 해당 데이터를 애플리케이션 정의 GUID와 연결합니다.

장치 개체에 애플리케이션 정의 데이터를 설정하고 해당 데이터를 애플리케이션 정의 **GUID**와 연결합니다.

## 구문

```cpp theme={null}
HRESULT SetPrivateData(
    const GUID & guid,
    UINT DataSize,
    const void  pData
)
```

### 매개 변수

*guid \[in]*\
형식: const GUID &

데이터와 연결할 **GUID**입니다.

*DataSize \[in]*\
형식: UINT

데이터의 크기(바이트 단위)입니다.

*pData \[in, optional]*\
형식: const void \*

이 장치 개체와 함께 저장될 데이터를 포함하는 메모리 블록에 대한 포인터입니다. <i>pData</i>가 **NULL**이면 <i>DataSize</i>도 0이어야 하며, <i>guid</i>에 지정된 **GUID**와 이전에 연결된 모든 데이터가 소멸됩니다.

### 반환 값

형식: HRESULT

이 메서드는 [Direct3D 12 반환 코드](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) 중 하나를 반환합니다.

## 설명

ASCII 이름과 함께 **WKPDID\_D3DDebugObjectName**을 사용하여 **ID3D12Object::SetPrivateData**를 호출하는 Direct3D 11 디버그 개체 이름 지정 체계를 사용하지 말고,
UNICODE 이름과 함께 [ID3D12Object::SetName](/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public)을 호출하세요.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[ID3D12Object](/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

- [SetName](/ko/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [SetPrivateDataInterface](/ko/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [GetPrivateData](/ko/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public.md)
- [PFUserDataPermission](/ko/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission.md)