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

另请参阅

IDirectDrawSurface7