Metode IDirect3DDevice9::CreateAdditionalSwapChain (d3d9.h)

  • Artikel

Membuat rantai pertukaran tambahan untuk merender beberapa tampilan.

Sintaks

HRESULT CreateAdditionalSwapChain(
  [in, out]     D3DPRESENT_PARAMETERS *pPresentationParameters,
  [out, retval] IDirect3DSwapChain9   **pSwapChain
);

Parameter

[in, out] pPresentationParameters

Jenis: D3DPRESENT_PARAMETERS*

Arahkan ke struktur D3DPRESENT_PARAMETERS , yang berisi parameter presentasi untuk rantai pertukaran baru. Nilai ini tidak boleh NULL.

Memanggil metode ini mengubah nilai anggota struktur D3DPRESENT_PARAMETERS.

  • Jika BackBufferCount == 0, memanggil CreateAdditionalSwapChain akan meningkatkannya menjadi 1.
  • Jika aplikasi dalam mode berjendela, dan jika BackBufferWidth atau BackBufferHeight == 0, aplikasi akan diatur ke lebar area klien dan tinggi hwnd.

[out, retval] pSwapChain

Jenis: IDirect3DSwapChain9**

Alamat pointer ke antarmuka IDirect3DSwapChain9 , mewakili rantai pertukaran tambahan.

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_NOTAVAILABLE, D3DERR_DEVICELOST, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Keterangan

Selalu ada setidaknya satu rantai pertukaran (rantai pertukaran implisit) untuk setiap perangkat karena Direct3D 9 memiliki satu rantai pertukaran sebagai properti perangkat.

Perhatikan bahwa perangkat tertentu hanya dapat mendukung satu rantai pertukaran layar penuh.

D3DFMT_UNKNOWN dapat ditentukan untuk format buffer belakang mode berjendela saat memanggil IDirect3D9::CreateDevice, IDirect3DDevice9::Reset dan CreateAdditionalSwapChain. Ini berarti aplikasi tidak perlu mengkueri format desktop saat ini sebelum memanggil CreateDevice untuk mode berjendela. Untuk mode layar penuh, format buffer belakang harus ditentukan.

Persyaratan

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

Lihat juga

IDirect3DDevice9

Menyajikan Beberapa Tampilan dalam Mode Berjendela (Direct3D 9)