IDirect3DSwapChain9::GetFrontBufferData メソッド

IDirect3DSwapChain9::GetFrontBufferData メソッド

スワップ チェーンのフロント バッファのコピーを生成し、アプリケーションが提供するシステム メモリ バッファにそのコピーを格納する。

構文

HRESULT GetFrontBufferData(      
    IDirect3DSurface9 *pDestSurface
);

パラメータ

• pDestSurface
  [in, out] IDirect3DSurface9 インターフェイスへのポインタ。 スワップ チェーンのフロント バッファのコピーを受け取る。データは、一番上の行から始めて一番下の行まで、間にスペースを挟まない連続した行として返される。

  ウィンドウ モードの場合、転送先サーフェイスのサイズは、デスクトップのサイズでなければならない。フルスクリーン モードの場合、転送先サーフェイスのサイズは、スクリーンのサイズでなければならない。

戻り値

成功した場合は、D3D_OK を返す。

BackBuffer がバック バッファの総数以上の場合、関数は失敗し、D3DERR_INVALIDCALL を返す。

注意

このメソッドを呼び出すと、IDirect3DSurface9 インターフェイスについての内部参照カウントが増加する。この IDirect3DSurface9 インターフェイスの使用を終了したときに IUnknown::Release を呼び出さないと、メモリ リークが発生する。