IDirect3DDevice9::GetBackBuffer
デバイスのスワップ チェーンからバック バッファーを取得します。
HRESULT
GetBackBuffer(
UINT iSwapChain,
UINT BackBuffer,
D3DBACKBUFFER_TYPE Type,
IDirect3DSurface9 ** ppBackBuffer
);
パラメータ
- iSwapChain
スワップ チェーンを指定する符号なし整数です。 - BackBuffer
返されるバック バッファー オブジェクトのインデックスです。バック バッファーの番号は、0 から始まり、バック バッファーの総数から 1 を引いた数まで続きます。値 0 を指定すると、フロント バッファーではなく、1 番目のバック バッファーが返されます。このメソッドを使用してフロント バッファーにアクセスすることはできません。フロント バッファーのコピーを取得するには、IDirect3DDevice9::GetFrontBufferData を使用します。 - Type
Direct3D 9 では、ステレオ ビューはサポートされていません。このため、このパラメーターに有効な値は D3DBACKBUFFER_TYPE_MONO のみです。 - ppBackBuffer
返されるバック バッファー サーフェスを表す IDirect3DSurface9 インターフェイスへのポインターのアドレスです。
戻り値
メソッドが成功した場合は、D3D_OK を返します。BackBuffer がバック バッファーの総数以上の値であると、この関数は失敗し、D3DERR_INVALIDCALL を返します。
解説
このメソッドを呼び出した後は、IDirect3DSurface9 インターフェイスの内部リファレンス カウントが増加します。この IDirect3DSurface9 インターフェイスの使用を終了したときに IUnknown::Release を呼び出さないと、メモリー リークが発生します。
要件
ヘッダー: D3D9.h 宣言
ライブラリ: D3D9.lib 内容