struktur DXGK_PRESENTFLAGS (d3dkmddi.h)

Artikel
03/08/2023

Struktur DXGK_PRESENTFLAGS mengidentifikasi, dalam bendera bit-field, jenis operasi saat ini untuk dilakukan.

Sintaks

typedef struct _DXGK_PRESENTFLAGS {
  union {
    struct {
      UINT Blt : 1;
      UINT ColorFill : 1;
      UINT Flip : 1;
      UINT FlipWithNoWait : 1;
      UINT SrcColorKey : 1;
      UINT DstColorKey : 1;
      UINT LinearToSrgb : 1;
      UINT Rotate : 1;
      UINT FlipStereo : 1;
      UINT FlipStereoTemporaryMono : 1;
      UINT FlipStereoPreferRight : 1;
      UINT BltStereoUseRight : 1;
      UINT FlipWithMultiPlaneOverlay : 1;
      UINT RedirectedFlip : 1;
#if ...
      UINT Reserved : 18;
#elif
      UINT Reserved : 19;
#else
      UINT Reserved : 24;
#endif
    };
    [in] UINT Value;
  };
} DXGK_PRESENTFLAGS;

Anggota

[in] Blt

Nilai UINT yang menentukan apakah operasi salin, alih-alih operasi balik, terjadi antara permukaan sumber dan tujuan.

Mengatur anggota ini setara dengan mengatur bit pertama dari anggota Nilai 32-bit (0x00000001).

[in] ColorFill

Nilai UINT yang menentukan apakah sumber ada untuk disajikan. Jika anggota ini diatur, tidak ada sumber, dan driver harus mengisi persegi panjang tujuan pada permukaan tujuan dengan warna A8R8G8B8 yang ditentukan anggota Warna dari struktur DXGKARG_PRESENT .

Mengatur anggota ini setara dengan mengatur bit kedua dari anggota Nilai 32-bit (0x00000002).

[in] Flip

Nilai UINT yang menentukan apakah operasi balik terjadi antara permukaan belakang dan primer. Jika anggota ini diatur, driver harus melakukan operasi saat ini dengan mengarahkan output pemindaian video ke sumber daripada menyalin dari sumber ke tujuan. Jenis operasi saat ini bebas air mata.

Mengatur anggota ini setara dengan mengatur bit ketiga dari anggota Nilai 32-bit (0x00000004).

[in] FlipWithNoWait

Nilai UINT yang menentukan apakah operasi balik bebas air mata tidak boleh menunda alur grafis. Jika flip bebas air mata menyimpan alur grafis, unit pemrosesan grafis (GPU) harus menunggu flip bebas air mata berlaku sebelum menjalankan perintah berikutnya.

FlipWithNoWait dapat diatur ke TRUE (yaitu, 1) hanya jika driver miniport tampilan mengatur bendera bit-field FlipOnVSyncWithNoWait di anggota FlipCaps dari struktur DXGK_DRIVERCAPS ketika nilai DXGKQAITYPE_DRIVERCAPS ditentukan dalam anggota Jenis struktur DXGKARG_QUERYADAPTERINFO dalam panggilan ke fungsi DxgkDdiQueryAdapterInfo driver.

Mengatur anggota ini setara dengan mengatur bit keempat dari anggota Nilai 32-bit (0x00000008).

[in] SrcColorKey

Nilai UINT yang menentukan apakah akan melakukan tombol warna sumber dengan menggunakan nilai di anggota Warna dari struktur DXGKARG_PRESENT . Artinya, piksel apa pun di permukaan sumber yang cocok dengan kunci warna tidak boleh disalin ke permukaan tujuan, dan semua piksel sumber yang tidak cocok dengan kunci warna harus disalin.

Mengatur anggota ini setara dengan mengatur bit kelima dari anggota Nilai 32-bit (0x00000010).

[in] DstColorKey

Nilai UINT yang menentukan apakah akan melakukan keying warna tujuan dengan menggunakan nilai di anggota Warna struktur DXGKARG_PRESENT . Artinya, piksel apa pun di permukaan tujuan yang cocok dengan kunci warna harus diganti dengan piksel yang sesuai dari permukaan sumber, dan semua piksel tujuan yang tidak cocok dengan kunci warna tidak boleh diganti.

Mengatur anggota ini setara dengan mengatur bit keenam dari anggota Nilai 32-bit (0x00000020).

[in] LinearToSrgb

Nilai UINT yang menentukan apakah akan mengonversi sumber berformat linier ke format sRGB selama operasi salin. format sRGB dikoreksi gamma. Untuk informasi selengkapnya tentang format sRGB, kunjungi situs web sRGB .

Mengatur anggota ini setara dengan mengatur bit ketujuh dari anggota Nilai 32-bit (0x00000040).

[in] Rotate

Nilai UINT yang menentukan apakah akan memutar data presentasi agar sesuai dengan orientasi layar saat ini selama transfer blok bit presentasi (bitblt). Orientasi layar saat ini diatur dalam anggota Rotasi dari struktur D3DKMDT_VIDPN_PRESENT_PATH_TRANSFORMATION , yang diatur dalam anggota ContentTransformation dari struktur D3DKMDT_VIDPN_PRESENT_PATH untuk jalur video yang ada.

Driver miniport tampilan harus memutar data hanya jika bendera Putar bit-field diatur. Bahkan jika driver menentukan bahwa orientasi layar saat ini diputar dari data presentasi dan Putar tidak diatur, driver tidak boleh memutar data.

Mengatur anggota ini setara dengan mengatur bit kedelapan dari anggota Nilai 32-bit (0x00000080).

[in] FlipStereo

Menentukan apakah driver harus membalik gambar kiri dan kanan alokasi stereo.

Jika anggota FlipOnNextVSync dari struktur DXGK_SETVIDPNSOURCEADDRESS_FLAGS diatur, driver harus menyelesaikan flip ke gambar kiri pada VSync berikutnya dan kemudian menyelesaikan flip ke gambar kanan pada VSync berikut.

Jika anggota FlipImmediate dari struktur DXGK_SETVIDPNSOURCEADDRESS_FLAGS diatur, driver harus segera mulai memindai dari alokasi baru. Misalnya, jika driver memindai gambar yang tepat, driver harus memulai pemindaian baru dari offset relatif yang sama dalam gambar yang tepat dari alokasi baru.

Anggota FlipStereo dan FlipStereoTemporaryMono tidak dapat keduanya diatur secara bersamaan.

Untuk persyaratan selengkapnya, lihat bagian Keterangan.

Mengatur anggota ini setara dengan mengatur bit kesembilan dari anggota Nilai 32-bit (0x00000100).

Didukung dimulai dengan Windows 8.

[in] FlipStereoTemporaryMono

Menentukan apakah driver harus menggunakan gambar kiri alokasi stereo untuk bagian kanan dan kiri bingkai stereo. Driver melakukan operasi saat ini yang sama seperti FlipStereo, kecuali bahwa ia harus memindai hanya dari gambar kiri untuk menghasilkan kedua gambar bingkai stereo.

Anggota ini harus diatur hanya jika driver melaporkan dukungan untuk opsi ini dalam mode tampilan saat ini dengan mengatur anggota Jenis struktur D3DKMDT_VIDPN_SOURCE_MODE ke D3DKMDT_RMT_GRAPHICS_STEREO_ADVANCED_SCAN.

Anggota FlipStereo dan FlipStereoTemporaryMono tidak dapat keduanya diatur secara bersamaan.

Anggota FlipStereoTemporaryMono dan FlipStereoPreferRight tidak dapat keduanya diatur secara bersamaan.

Untuk persyaratan selengkapnya, lihat bagian Keterangan.

Mengatur anggota ini setara dengan mengatur bit kesepuluh dari anggota Nilai 32-bit (0x00000200).

Didukung dimulai dengan Windows 8.

[in] FlipStereoPreferRight

Menentukan bahwa ketika driver mengkloning alokasi utama stereo ke monitor mono, ia harus menggunakan gambar yang tepat.

Anggota FlipStereoTemporaryMono dan FlipStereoPreferRight tidak dapat keduanya diatur secara bersamaan.

Untuk persyaratan selengkapnya, lihat bagian Keterangan.

Mengatur anggota ini setara dengan mengatur bit ke-11 dari anggota Nilai 32-bit (0x00000400).

Didukung dimulai dengan Windows 8.

[in] BltStereoUseRight

Menentukan bahwa ketika driver menyajikan dari alokasi stereo ke alokasi mono, driver harus menggunakan gambar yang tepat. Jika tidak diatur, driver harus menggunakan gambar kiri.

Mengatur anggota ini setara dengan mengatur bit ke-12 dari anggota Nilai 32-bit (0x00000800).

Didukung dimulai dengan Windows 8.

[in] FlipWithMultiPlaneOverlay

Menentukan apakah operasi flip terjadi antara bidang overlay dan permukaan utama. Jika anggota ini diatur, driver harus melakukan operasi saat ini dengan mengarahkan output pemindaian video ke bidang sumber daripada menyalin dari bidang sumber ke tujuan.

Mengatur anggota ini setara dengan mengatur bit ketiga belas dari anggota Nilai 32-bit (0x00001000).

Didukung dimulai dengan Windows 8.1.

RedirectedFlip

[in] Reserved

Anggota ini dicadangkan dan harus diatur ke nol.

Mengatur anggota ini ke nol setara dengan mengatur 19 bit yang tersisa (0xFFFFE000) dari anggota Nilai 32-bit ke nol.

Didukung dimulai dengan Windows 8.

[in] Anggota ini dicadangkan dan harus diatur ke nol.

Mengatur anggota ini ke nol setara dengan mengatur 24 bit yang tersisa (0xFFFFFF00) dari anggota Nilai 32-bit ke nol.

[in] Value

Anggota dalam serikat yang DXGK_PRESENTFLAGS berisi yang dapat menyimpan nilai 32-bit yang mengidentifikasi jenis operasi saat ini untuk dilakukan.

Keterangan

Bendera bidang bit ColorFill, SrcColorKey, dan DstColorKey saling eksklusif.

Jika salah satu anggota FlipStereo, FlipStereoTemporaryMono, atau FlipStereoPreferRight ditetapkan, kondisi ini berlaku:

Anggota hAllocation dari struktur DXGKARG_SETVIDPNSOURCEADDRESS harus menunjuk ke alokasi yang dibuat dengan anggota Stereo yang diatur dalam anggota Bendera dari struktur D3DKMT_DISPLAYMODE .
Anggota PrimarySegment dan PrimaryAddressdari DXGKARG_SETVIDPNSOURCEADDRESS harus menunjuk ke alamat fisik awal alokasi.
Driver harus menghormati pengaturan anggota FlipImmediate dan FlipOnNextVSync dari struktur DXGK_SETVIDPNSOURCEADDRESS_FLAGS .