IDirect3DDevice9::GetBackBuffer メソッド (d3d9.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
Direct3D 9 ではステレオ ビューはサポートされていないため、このパラメーターの有効な値はD3DBACKBUFFER_TYPE_MONOのみです。
[out, retval] ppBackBuffer
種類: IDirect3DSurface9**
返されたバック バッファーサーフェスを表す IDirect3DSurface9 インターフェイスへのポインターのアドレス。
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 BackBuffer がバック バッファーの合計数と等しいか、または超えている場合、関数は失敗し、D3DERR_INVALIDCALLを返します。
解説
このメソッドを呼び出すと、 IDirect3DSurface9 インターフェイスの内部参照数が増えます。 この IDirect3DSurface9 インターフェイスの使用が完了したときに IUnknown::Release を呼び出さなかった場合、メモリ リークが発生します。
要件
対象プラットフォーム | Windows |
ヘッダー | d3d9.h (D3D9.h を含む) |
Library | D3D9.lib |