> ## 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](/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](/zh-CN/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setname_public.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [SetPrivateDataInterface](/zh-CN/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_setprivatedatainterface_public.md)
- [GetPrivateData](/zh-CN/reference/graphics/d3d12/interfaces/id3d12object/methods/id3d12object_getprivatedata_public.md)
- [PFUserDataPermission](/zh-CN/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission.md)