Share via

IDirect3DDevice9::GetFrontBufferData メソッド (d3d9helper.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] iSwapChain

型: UINT

スワップ チェーンを指定する符号なし整数。

[in] pDestSurface

種類: IDirect3DSurface9*

フロント バッファーの内容のコピーを受け取る IDirect3DSurface9 インターフェイスへのポインター。 データは、デバイスの出力の垂直方向に最も高い行から最も低い行まで、間にスペースのない連続した行で返されます。

ウィンドウ モードの場合、ターゲット サーフェスのサイズはデスクトップのサイズにする必要があります。 全画面表示モードの場合、移動先サーフェスのサイズは画面サイズにする必要があります。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_DRIVERINTERNALERROR、D3DERR_DEVICELOST、D3DERR_INVALIDCALL

解説

pDestSurface が指すバッファーには、フロント バッファーの表現が格納され、ピクセル形式D3DFMT_A8R8G8B8あたり標準の 32 ビットに変換されます。

この方法は、アンチエイリアシングされたスクリーン ショットをキャプチャする唯一の方法です。

この関数は設計上非常に遅く、パフォーマンスクリティカルなパスでは使用しないでください。

詳細については、「 紛失したデバイスと取得されたデータ」を参照してください。

要件

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

関連項目

IDirect3DDevice9