> ## 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](/reference/graphics/d3d12_xs/interfaces/ID3D12Object/id3d12object)


## Related topics

- [SetName](/zh-CN/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [SetPrivateData](/zh-CN/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedata_public.md)
- [SetPrivateDataInterface](/zh-CN/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [PFUserDataPermission](/zh-CN/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission.md)