IDirectDrawSurface7::GetPrivateData 方法 (ddraw.h)
将与此图面关联的专用数据复制到提供的缓冲区。
语法
HRESULT GetPrivateData(
[in] REFGUID unnamedParam1,
[out] LPVOID unnamedParam2,
[in, out] LPDWORD unnamedParam3
);
参数
[in] unnamedParam1
对 (C++) 或地址的引用 (C) 标识要检索的私有数据的全局唯一标识符。
[out] unnamedParam2
指向以前分配的缓冲区的指针,如果调用成功,该缓冲区将接收请求的私有数据。 调用此方法的应用程序必须分配并释放此缓冲区。
[in, out] unnamedParam3
指向变量的指针,该变量包含 lpBuffer 处缓冲区的大小值(以字节为单位)。 如果此值小于专用数据 (的实际大小(例如 0) ), 则 GetPrivateData 会将变量设置为所需的缓冲区大小,然后返回DDERR_MOREDATA。
返回值
如果方法成功,则返回值DD_OK。
如果失败,方法可能会返回以下错误值之一:
- DDERR_EXPIRED
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_MOREDATA
- DDERR_NOTFOUND
- DDERR_OUTOFMEMORY
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | ddraw.h |
Library | Ddraw.lib |
DLL | Ddraw.dll |