Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::GetBackBuffer

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

HRESULT GetBackBuffer(
  UINT BackBuffer,
  D3DBACKBUFFER_TYPE Type,
  IDirect3DSurface8** ppBackBuffer
);

パラメータ

BackBuffer
[in] 返されるバック バッファ オブジェクトのインデックス。バック バッファは 0 からバック バッファの総数 - 1 までナンバリングされる。0 の戻り値は最初のバック バッファを示し、フロント バッファではない。このメソッドを使用してフロント バッファにアクセスすることはできない。
Type
[in] DirectX 8.0 ではステレオ ビューはサポートされていないので、このパラメータの有効な値は D3DBACKBUFFER_TYPE_MONO だけである。
ppBackBuffer
[out, retval] 返されるバック バッファ サーフェスを表す IDirect3DSurface8 インターフェイスへのポインタのアドレス。

戻り値

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

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

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

動作環境

  ヘッダー : d3d8.h で宣言。
  インポート ライブラリ : D3d8.lib を使用。