IDirect3DSwapChain9::GetFrontBufferData メソッド (d3d9.h)

スワップチェーンのフロント バッファーのコピーを生成し、そのコピーをアプリケーションによって提供されるシステム メモリ バッファーに配置します。

構文

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

パラメーター

[in, out] pDestSurface

種類: IDirect3DSurface9*

スワップチェーンのフロント バッファーのコピーを受け取る IDirect3DSurface9 インターフェイスへのポインター。 データは連続する行で返され、垂直方向に最も高い行から最も低い行まで、間にスペースが入っていません。 ウィンドウ モードの場合、ターゲット サーフェスのサイズはデスクトップのサイズにする必要があります。 全画面表示モードの場合、コピー先サーフェスのサイズは画面サイズにする必要があります。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 BackBuffer がバック バッファーの合計数を超えるか等しい場合、関数は失敗し、D3DERR_INVALIDCALLを返します。

解説

このメソッドを呼び出すと、 IDirect3DSurface9 インターフェイスの内部参照数が増えます。 この IDirect3DSurface9 インターフェイスの使用が完了したときに IUnknown::Release を呼び出さなかった場合、メモリ リークが発生します。

要件

対象プラットフォーム	Windows
ヘッダー	d3d9.h (D3D9.h を含む)
Library	D3D9.lib

関連項目

IDirect3DSwapChain9