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

# GetPrivateData

> 從裝置物件取得應用程式定義的資料。

從裝置物件取得應用程式定義的資料。

## 語法

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

### 參數

*guid \[in]*\
類型：const GUID &

與資料相關聯的 **GUID**。

*pDataSize \[in, out]*\
類型：UINT \*

指向變數的指標，該變數在輸入時包含 <i>pData</i> 所指向之緩衝區的大小 (以位元組為單位)，在輸出時則包含 **GetPrivateData** 所擷取之資料量的大小 (以位元組為單位)。

*pData \[out, optional]*\
類型：void \*

指向記憶體區塊的指標，如果 <i>pDataSize</i> 指向的值所指定的緩衝區大到足以容納資料，該記憶體區塊就會從裝置物件接收資料。

### 傳回值

類型：HRESULT

此方法會傳回其中一個 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues)。

## 備註

如果傳回的資料是指向先前由 SetPrivateDataInterface 所設定之 [IUnknown](https://learn.microsoft.com/en-us/windows/desktop/api/unknwn/nn-unknwn-iunknown) 或其衍生類別之一的指標，則該介面的參考計數會在傳回私用資料之前遞增。

## 需求

**標頭:** 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)
- [SetPrivateData](/zh-TW/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)
- [SetPrivateDataInterface](/zh-TW/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [Get Shared Group Data](/api-reference/shared-group-data/get-shared-group-data.md)
- [Get User Data](/api-reference/player-data-management/get-user-data.md)