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

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

構文

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

パラメーター

[in] iBackBuffer

型: UINT

返すバック バッファー オブジェクトのインデックス。 バック バッファーには、0 からバック バッファーの合計数 - 1 に番号が付きます。 値 0 は、フロント バッファーではなく、最初のバック バッファーを返します。 フロント バッファーには、このメソッドを使用してアクセスできません。 フロント バッファーのコピーを取得するには、 IDirect3DSwapChain9::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 を呼び出さなかった場合、メモリ リークが発生します。 このメソッドを使用して取得したサーフェスは、そのサーフェスが属するスワップ チェーンを解放する前に解放する必要があります。

要件

こちらもご覧ください

IDirect3DSwapChain9

IDirect3DSwapChain9::GetFrontBufferData