IDirect3DSwapChain9::GetFrontBufferData 方法 (d3d9helper.h)

生成交换链前端缓冲区的副本,并将该副本放在应用程序提供的系统内存缓冲区中。

语法

HRESULT GetFrontBufferData(
  [in, out] IDirect3DSurface9 *pDestSurface
);

参数

[in, out] pDestSurface

类型: IDirect3DSurface9*

指向 IDirect3DSurface9 接口的指针,该接口将接收交换链的前端缓冲区的副本。 数据以连续的行返回,没有干预空间,从垂直最高行到最低行。 对于窗口模式,目标图面的大小应为桌面的大小。 对于全屏模式,目标图面的大小应为屏幕大小。

返回值

类型: HRESULT

如果方法成功,则返回值D3D_OK。 如果 BackBuffer 超过或等于后台缓冲区的总数,则 函数将失败并返回D3DERR_INVALIDCALL。

注解

调用此方法会增加 IDirect3DSurface9 接口上的内部引用计数。 使用此 IDirect3DSurface9 接口时调用 IUnknown::Release 失败会导致内存泄漏。

要求

要求
目标平台 Windows
标头 d3d9helper.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DSwapChain9