ID3D12Object::SetPrivateData 方法 (d3d12.h)

将应用程序定义的数据设置为设备对象,并将该数据与应用程序定义的 GUID 相关联。

语法

HRESULT SetPrivateData(
  [in]           REFGUID    guid,
  [in]           UINT       DataSize,
  [in, optional] const void *pData
);

参数

[in] guid

类型: REFGUID

要与数据关联的 GUID

[in] DataSize

类型: UINT

数据的大小(以字节为单位)。

[in, optional] pData

类型: const void*

指向内存块的指针,该内存块包含要随此设备对象一起存储的数据。 如果 pDataNULL则 DataSize 也必须为 0,并且之前与 guid 中指定的 GUID 关联的任何数据都将销毁。

返回值

类型: HRESULT

此方法返回 Direct3D 12 返回代码之一。

备注

使用具有 ASCII 名称的 WKPDID_D3DDebugObjectName 调用 ID3D12Object::SetPrivateData 的 Direct3D 11 调试对象命名方案,而不是使用 UNICODE 名称调用 ID3D12Object::SetName

要求

   
目标平台 Windows
标头 d3d12.h
Library D3D12.lib
DLL D3D12.dll

另请参阅

ID3D12Object