Metode IDirect3DDevice9::GetBackBuffer (d3d9helper.h)
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 |