struktur DXGI_PRESENT_PARAMETERS (dxgi1_2.h)

Menjelaskan informasi tentang presentasi yang membantu sistem operasi mengoptimalkan presentasi.

Sintaks

typedef struct DXGI_PRESENT_PARAMETERS {
  UINT  DirtyRectsCount;
  RECT  *pDirtyRects;
  RECT  *pScrollRect;
  POINT *pScrollOffset;
} DXGI_PRESENT_PARAMETERS;

Anggota

DirtyRectsCount

Jumlah persegi panjang yang diperbarui yang Anda perbarui di buffer belakang untuk bingkai yang disajikan. Sistem operasi menggunakan informasi ini untuk mengoptimalkan presentasi. Anda dapat mengatur anggota ini ke 0 untuk menunjukkan bahwa Anda memperbarui seluruh bingkai.

pDirtyRects

Daftar persegi panjang yang diperbarui yang Anda perbarui di buffer belakang untuk bingkai yang disajikan. Aplikasi harus memperbarui setiap piksel di setiap persegi panjang yang dilaporkan ke runtime; aplikasi tidak dapat mengasumsikan bahwa piksel disimpan dari bingkai sebelumnya. Untuk informasi selengkapnya tentang memperbarui persegi panjang kotor, lihat Keterangan. Anda dapat mengatur anggota ini ke NULL jika DirtyRectsCount adalah 0. Aplikasi tidak boleh memperbarui piksel apa pun di luar persegi panjang kotor.

pScrollRect

Penunjuk ke persegi panjang yang digulir. Persegi panjang yang digulir adalah persegi panjang bingkai sebelumnya tempat runtime bit-block mentransfer konten (bitblts). Runtime juga menggunakan persegi panjang yang digulir untuk mengoptimalkan presentasi di server terminal dan skenario tampilan tidak langsung.

Persegi panjang yang digulir juga menjelaskan persegi panjang tujuan, yaitu, wilayah pada bingkai saat ini yang diisi dengan konten yang digulir. Anda dapat mengatur anggota ini ke NULL untuk menunjukkan bahwa tidak ada konten yang digulir dari bingkai sebelumnya.

pScrollOffset

Penunjuk ke offset area yang digulir yang berubah dari persegi sumber (bingkai sebelumnya) ke persegi panjang tujuan (dari bingkai saat ini). Anda dapat mengatur anggota ini ke NULL untuk menunjukkan tidak ada offset.

Keterangan

Struktur ini digunakan oleh metode Present1 .

Persegi panjang gulir dan daftar persegi panjang kotor bisa tumpang tindih. Dalam situasi ini, persegi panjang kotor menjadi prioritas. Aplikasi kemudian dapat memiliki potongan konten dinamis di atas area yang digulir. Misalnya, aplikasi dapat menggulir halaman dan memutar video secara bersamaan.

Diagram dan koordinat berikut mengilustrasikan contoh ini.

DirtyRectsCount = 2
pDirtyRects[ 0 ] = { 10, 30, 40, 50 } // Video
pDirtyRects[ 1 ] = { 0, 70, 50, 80 } // New line
*pScrollRect = { 0, 0, 50, 70 }
*pScrollOffset = { 0, -10 }

Bagian dari bingkai dan konten sebelumnya yang dirender aplikasi digabungkan untuk menghasilkan bingkai akhir yang disajikan sistem operasi pada layar tampilan. Sebagian besar jendela digulir dari bingkai sebelumnya. Aplikasi harus memperbarui bingkai video dengan potongan konten baru yang muncul karena pengguliran.

Persegi panjang putus-putus memperlihatkan persegi panjang gulir dalam bingkai saat ini. Persegi panjang gulir ditentukan oleh anggota pScrollRect . Panah menunjukkan offset gulir. Offset gulir ditentukan oleh anggota pScrollOffset . Persegi panjang yang diisi menunjukkan persegi panjang kotor yang diperbarui aplikasi dengan konten baru. Persegi panjang yang diisi ditentukan oleh anggota DirtyRectsCount dan pDirtyRects .

Persegi panjang dan offset gulir tidak didukung untuk opsi DXGI_SWAP_EFFECT_DISCARD atau DXGI_SWAP_EFFECT_SEQUENTIAL ada. Persegi panjang kotor dan persegi panjang gulir tidak didukung untuk rantai pertukaran multisampel.

Implementasi aktual komposisi dan bitblt yang diperlukan berbeda untuk model bitblt dan model flip. Untuk informasi selengkapnya tentang model ini, lihat Model Balik DXGI.

Untuk informasi selengkapnya tentang rantai pertukaran model balik dan mengoptimalkan presentasi, lihat Meningkatkan presentasi dengan model balik, persegi panjang kotor, dan area yang digulir.

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 Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Header	dxgi1_2.h

Lihat juga

Struktur DXGI