将与卷关联的专用数据复制到提供的缓冲区。
语法
HRESULT GetPrivateData(
[in] REFGUID refguid,
[in, out] void *pData,
[in, out] DWORD *pSizeOfData
);
参数
[in] refguid
类型: REFGUID
对 (C++) 或 (C) 的地址的引用,该标识符标识要检索的私有数据。
[in, out] pData
类型:void*
指向以前分配的缓冲区的指针,以填充请求的专用数据(如果调用成功)。 调用此方法的应用程序负责分配和释放此缓冲区。 如果此参数为 NULL,此方法将返回 pSizeOfData 中的缓冲区大小。
[in, out] pSizeOfData
类型: DWORD*
指向 pData 上的缓冲区大小的指针,以字节为单位。 如果此值小于专用数据的实际大小(如 0),则该方法将此参数设置为所需的缓冲区大小,并且该方法返回D3DERR_MOREDATA。
返回值
类型:HRESULT
如果方法成功,则返回值D3D_OK。 如果方法失败,则返回值可以是下列值之一:D3DERR_INVALIDCALL、D3DERR_MOREDATA、D3DERR_NOTFOUND。
注解
如果返回的数据是指向 IUnknown 的指针,或者其派生类之一(以前由 SetPrivateData 使用 D3DSPD_IUNKNOWN 标志设置),该接口将在返回专用数据之前递增其引用计数。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | Windows操作系统 |
| 标头 | d3d9.h (包括 D3D9.h) |
| 图书馆 | D3D9.lib |