Metode IDirect3DDevice9::GetBackBuffer (d3d9helper.h)

  • Artikel

Mengambil buffer kembali dari rantai pertukaran perangkat.

Sintaks

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

Parameter

[in] iSwapChain

Jenis: UINT

Bilangan bulat yang tidak ditandatangani yang menentukan rantai pertukaran.

[in] iBackBuffer

Jenis: UINT

Indeks objek buffer belakang yang akan dikembalikan. Buffer belakang dinomor dari 0 hingga jumlah total buffer belakang dikurangi satu. Nilai 0 mengembalikan buffer belakang pertama, bukan buffer depan. Buffer depan tidak dapat diakses melalui metode ini. Gunakan IDirect3DDevice9::GetFrontBufferData untuk mengambil salinan buffer depan.

[in] Type

Jenis: D3DBACKBUFFER_TYPE

Tampilan stereo tidak didukung di Direct3D 9, sehingga satu-satunya nilai yang valid untuk parameter ini adalah D3DBACKBUFFER_TYPE_MONO.

[out, retval] ppBackBuffer

Jenis: IDirect3DSurface9**

Alamat penunjuk ke antarmuka IDirect3DSurface9 , mewakili permukaan buffer kembali yang dikembalikan.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika BackBuffer sama atau melebihi jumlah total buffer back, maka fungsi gagal dan mengembalikan D3DERR_INVALIDCALL.

Keterangan

Memanggil metode ini akan meningkatkan jumlah referensi internal pada antarmuka IDirect3DSurface9 . Kegagalan untuk memanggil IUnknown::Release setelah selesai menggunakan antarmuka IDirect3DSurface9 ini menghasilkan kebocoran memori.

Persyaratan

   
Target Platform Windows
Header d3d9helper.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

IDirect3DDevice9

IDirect3DDevice9::GetFrontBufferData