struktur DXGI_SWAP_CHAIN_DESC1 (dxgi1_2.h)

Artikel
04/21/2023

Menjelaskan rantai pertukaran.

Sintaks

typedef struct DXGI_SWAP_CHAIN_DESC1 {
  UINT             Width;
  UINT             Height;
  DXGI_FORMAT      Format;
  BOOL             Stereo;
  DXGI_SAMPLE_DESC SampleDesc;
  DXGI_USAGE       BufferUsage;
  UINT             BufferCount;
  DXGI_SCALING     Scaling;
  DXGI_SWAP_EFFECT SwapEffect;
  DXGI_ALPHA_MODE  AlphaMode;
  UINT             Flags;
} DXGI_SWAP_CHAIN_DESC1;

Anggota

Width

Nilai yang menjelaskan lebar resolusi. Jika Anda menentukan lebar sebagai nol saat Anda memanggil metode IDXGIFactory2::CreateSwapChainForHwnd untuk membuat rantai pertukaran, runtime mendapatkan lebar dari jendela output dan menetapkan nilai lebar ini ke deskripsi swap-chain. Anda kemudian dapat memanggil metode IDXGISwapChain1::GetDesc1 untuk mengambil nilai lebar yang ditetapkan. Anda tidak dapat menentukan lebar sebagai nol saat memanggil metode IDXGIFactory2::CreateSwapChainForComposition .

Height

Nilai yang menjelaskan tinggi resolusi. Jika Anda menentukan tinggi sebagai nol saat Anda memanggil metode IDXGIFactory2::CreateSwapChainForHwnd untuk membuat rantai pertukaran, runtime mendapatkan tinggi dari jendela output dan menetapkan nilai tinggi ini ke deskripsi rantai swap. Anda kemudian dapat memanggil metode IDXGISwapChain1::GetDesc1 untuk mengambil nilai tinggi yang ditetapkan. Anda tidak dapat menentukan tinggi sebagai nol saat memanggil metode IDXGIFactory2::CreateSwapChainForComposition .

Format

Struktur DXGI_FORMAT yang menjelaskan format tampilan.

Stereo

Menentukan apakah mode tampilan layar penuh atau buffer belakang rantai swap adalah stereo. TRUE jika stereo; jika tidak, FALSE. Jika Anda menentukan stereo, Anda juga harus menentukan rantai pertukaran model flip (yaitu, rantai pertukaran yang memiliki nilai DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL yang ditetapkan dalam anggota SwapEffect ).

SampleDesc

Struktur DXGI_SAMPLE_DESC yang menjelaskan parameter multi-pengambilan sampel. Anggota ini hanya berlaku dengan rantai pertukaran model transfer bit-block (bitblt).

BufferUsage

Nilai yang diketik DXGI_USAGE yang menjelaskan opsi penggunaan permukaan dan akses CPU untuk buffer belakang. Buffer belakang dapat digunakan untuk input shader atau output target render.

BufferCount

Nilai yang menjelaskan jumlah buffer dalam rantai pertukaran. Saat membuat rantai pertukaran layar penuh, Anda biasanya menyertakan buffer depan dalam nilai ini.

Scaling

Nilai yang diketik DXGI_SCALING yang mengidentifikasi perilaku mengubah ukuran jika ukuran buffer belakang tidak sama dengan output target.

SwapEffect

Nilai yang diketik DXGI_SWAP_EFFECT yang menjelaskan model presentasi yang digunakan oleh rantai pertukaran dan opsi untuk menangani konten buffer presentasi setelah menyajikan permukaan. Anda harus menentukan nilai DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL saat memanggil metode IDXGIFactory2::CreateSwapChainForComposition karena metode ini hanya mendukung model presentasi balik.

AlphaMode

Nilai DXGI_ALPHA_MODE yang diketik yang mengidentifikasi perilaku transparansi buffer swap-chain back.

Flags

Kombinasi nilai DXGI_SWAP_CHAIN_FLAG-jenis yang digabungkan dengan menggunakan operasi OR bitwise. Nilai yang dihasilkan menentukan opsi untuk perilaku swap-chain.

Keterangan

Struktur ini digunakan oleh metode CreateSwapChainForHwnd, CreateSwapChainForCoreWindow, CreateSwapChainForComposition, CreateSwapChainForCompositionSurfaceHandle, dan GetDesc1 .

Catatan Anda tidak dapat melemparkan DXGI_SWAP_CHAIN_DESC1 ke DXGI_SWAP_CHAIN_DESC dan sebaliknya. Aplikasi harus secara eksplisit menggunakan metode IDXGISwapChain1::GetDesc1 untuk mengambil versi struktur deskripsi rantai pertukaran yang lebih baru.

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

Untuk rantai pertukaran model balik (yaitu, rantai pertukaran yang memiliki nilai DXGI_SWAP_EFFECT_FLIP_DISCARD atau DXGI_SWAP_EFFECT_FLIP_SEQUENTIAL yang ditetapkan dalam anggota SwapEffect ), Anda harus mengatur anggota Format ke DXGI_FORMAT_R16G16B16A16_FLOAT, DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_R8G8B8A8_UNORM, atau DXGI_FORMAT_R10G10B10A10_UNORM; Anda harus mengatur anggota Count dari struktur DXGI_SAMPLE_DESC yang ditentukan anggota SampleDesc ke satu dan anggota KualitasDXGI_SAMPLE_DESC ke nol karena beberapa antialias sampel (MSAA) tidak didukung; Anda harus mengatur anggota BufferCount ke dari dua hingga enam belas. Untuk informasi selengkapnya tentang rantai pertukaran model balik, lihat Model Flip DXGI.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Platform Update untuk Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Header	dxgi1_2.h

Lihat juga

Struktur DXGI

IDXGISwapChain1::GetDesc1

Bagikan melalui