struktur DXGI_SWAP_CHAIN_DESC (dxgi.h)

Menjelaskan rantai pertukaran.

Sintaks

typedef struct DXGI_SWAP_CHAIN_DESC {
  DXGI_MODE_DESC   BufferDesc;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  HWND             OutputWindow;
  BOOL             Windowed;
  DXGI_SWAP_EFFECT SwapEffect;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC;

Anggota

BufferDesc

Jenis: DXGI_MODE_DESC

Struktur DXGI_MODE_DESC yang menjelaskan mode tampilan backbuffer.

SampleDesc

Jenis: DXGI_SAMPLE_DESC

Struktur DXGI_SAMPLE_DESC yang menjelaskan parameter multi-pengambilan sampel.

BufferUsage

Jenis: DXGI_USAGE

Anggota jenis enumerasi DXGI_USAGE yang menjelaskan opsi penggunaan permukaan dan akses CPU untuk buffer belakang. Buffer belakang dapat digunakan untuk input shader atau output render-target.

BufferCount

Jenis: UINT

Nilai yang menjelaskan jumlah buffer dalam rantai pertukaran. Saat Anda memanggil IDXGIFactory::CreateSwapChain untuk membuat rantai pertukaran layar penuh, Anda biasanya menyertakan buffer depan dalam nilai ini. Untuk informasi selengkapnya tentang buffer swap-chain, lihat Komentar.

OutputWindow

Jenis: HWND

Handel HWND ke jendela output. Anggota ini tidak boleh NULL.

Windowed

Jenis: BOOL

Nilai Boolean yang menentukan apakah output berada dalam mode berjendela. TRUE jika output dalam mode berjendela; jika tidak, FALSE.

Kami menyarankan agar Anda membuat rantai pertukaran berjendela dan memungkinkan pengguna akhir untuk mengubah rantai pertukaran ke layar penuh melalui IDXGISwapChain::SetFullscreenState; artinya, jangan atur anggota ini ke FALSE untuk memaksa rantai pertukaran menjadi layar penuh. Namun, jika Anda membuat rantai pertukaran sebagai layar penuh, berikan juga daftar mode tampilan yang didukung kepada pengguna akhir melalui anggota BufferDesc karena rantai pertukaran yang dibuat dengan mode tampilan yang tidak didukung dapat menyebabkan tampilan menjadi hitam dan mencegah pengguna akhir melihat apa pun.

Untuk informasi selengkapnya tentang memilih layar penuh ayat berjendela, lihat IDXGIFactory::CreateSwapChain.

SwapEffect

Jenis: DXGI_SWAP_EFFECT

Anggota tipe DXGI_SWAP_EFFECT yang dijumlahkan yang menjelaskan opsi untuk menangani konten buffer presentasi setelah menyajikan permukaan.

Flags

Jenis: UINT

Anggota jenis DXGI_SWAP_CHAIN_FLAG yang dijumlahkan yang menjelaskan opsi untuk perilaku rantai pertukaran.

Keterangan

Struktur ini digunakan oleh metode GetDesc dan CreateSwapChain .

Dalam mode layar penuh, ada buffer depan khusus; dalam mode berjendela, desktop adalah buffer depan.

Jika Anda membuat rantai pertukaran dengan satu buffer, menentukan DXGI_SWAP_EFFECT_SEQUENTIAL tidak menyebabkan konten buffer tunggal ditukar dengan buffer depan.

Untuk informasi performa tentang membalik buffer swap-chain dalam aplikasi layar penuh, lihat Petunjuk Performa Aplikasi Layar Penuh.

Persyaratan

Header	dxgi.h

Lihat juga

Struktur DXGI

IDXGIFactory::CreateSwapChain

IDXGISwapChain