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

## 備註

請不要使用 Direct3D 11 的偵錯物件命名方式 (以 ASCII 名稱搭配 **WKPDID\_D3DDebugObjectName** 呼叫 **ID3D12Object::SetPrivateData**)，
而應以 UNICODE 名稱呼叫 [ID3D12Object::SetName](/zh-TW/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](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

- [SetName](/zh-TW/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [SetPrivateDataInterface](/zh-TW/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [GetPrivateData](/zh-TW/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public.md)
- [Update Shared Group Data](/api-reference/shared-group-data/update-shared-group-data.md)
- [Update User Data](/api-reference/player-data-management/update-user-data.md)