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

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

構文

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

[in] iSwapChain

型: UINT

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

[in] pDestSurface

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

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

種類: HRESULT

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

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

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

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

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