Metode IDirect3DSwapChain9::GetBackBuffer (d3d9helper.h)
Mengambil buffer kembali dari rantai pertukaran perangkat.
Sintaks
HRESULT GetBackBuffer(
[in] UINT iBackBuffer,
[in] D3DBACKBUFFER_TYPE Type,
[out, retval] IDirect3DSurface9 **ppBackBuffer
);
Parameter
[in] iBackBuffer
Jenis: UINT
Indeks objek buffer belakang yang akan dikembalikan. Buffer belakang dinomor dari 0 hingga jumlah total buffer belakang - 1. Nilai 0 mengembalikan buffer belakang pertama, bukan buffer depan. Buffer depan tidak dapat diakses melalui metode ini. Gunakan IDirect3DSwapChain9::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.
Nilai kembali
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika BackBuffer melebihi atau sama dengan 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. Anda harus melepaskan permukaan apa pun yang diperoleh melalui metode ini sebelum melepaskan rantai pertukaran miliknya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Windows |
| Header | d3d9helper.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |