Share via

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

  • [アーティクル]

デバイスのスワップ チェーンからバック バッファーを取得します。

構文

HRESULT GetBackBuffer(
  [in]          UINT               iSwapChain,
  [in]          UINT               iBackBuffer,
  [in]          D3DBACKBUFFER_TYPE Type,
  [out, retval] IDirect3DSurface9  **ppBackBuffer
);

パラメーター

[in] iSwapChain

型: UINT

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

[in] iBackBuffer

型: UINT

返すバック バッファー オブジェクトのインデックス。 バック バッファーには、0 からバック バッファーの合計数から 1 を引いた番号が付きます。 値 0 は、フロント バッファーではなく、最初のバック バッファーを返します。 フロント バッファーには、このメソッドを使用してアクセスできません。 IDirect3DDevice9::GetFrontBufferData を使用して、フロント バッファーのコピーを取得します。

[in] Type

種類: D3DBACKBUFFER_TYPE

Direct3D 9 ではステレオ ビューはサポートされていないため、このパラメーターの有効な値はD3DBACKBUFFER_TYPE_MONOのみです。

[out, retval] ppBackBuffer

種類: IDirect3DSurface9**

返されたバック バッファーサーフェスを表す IDirect3DSurface9 インターフェイスへのポインターのアドレス。

戻り値

種類: HRESULT

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

解説

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

要件

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

関連項目

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData