struktur DXGK_SETVIDPNSOURCEADDRESS_FLAGS (d3dkmddi.h)

Artikel
03/08/2023

Struktur DXGK_SETVIDPNSOURCEADDRESS_FLAGS mengidentifikasi jenis operasi tertentu untuk dilakukan dalam panggilan ke fungsi DxgkDdiSetVidPnSourceAddress tampilan miniport atau DxgkDdiSetVidPnSourceAddressWithMultiPlaneOverlay .

Sintaks

typedef struct _DXGK_SETVIDPNSOURCEADDRESS_FLAGS {
  union {
    struct {
      UINT ModeChange : 1;
      UINT FlipImmediate : 1;
      UINT FlipOnNextVSync : 1;
      UINT FlipStereo : 1;
      UINT FlipStereoTemporaryMono : 1;
      UINT FlipStereoPreferRight : 1;
      UINT SharedPrimaryTransition : 1;
      UINT IndependentFlipExclusive : 1;
      UINT MoveFlip : 1;
#if ...
      UINT Reserved : 23;
#elif
      UINT Reserved : 24;
#elif
      UINT Reserved : 25;
#else
      UINT Reserved : 29;
#endif
    };
         UINT Value;
  };
} DXGK_SETVIDPNSOURCEADDRESS_FLAGS;

Anggota

ModeChange

Nilai UINT yang menentukan driver untuk mengalihkan mode tampilan.

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

FlipImmediate

Nilai UINT yang menentukan driver untuk melakukan operasi balik yang terjadi tanpa sinkronisasi vertikal.

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

FlipOnNextVSync

Nilai UINT yang menentukan driver untuk melakukan operasi balik yang terjadi pada sinkronisasi vertikal berikutnya.

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

[in] FlipStereo

Didukung dimulai dengan Windows 8.

Menentukan apakah driver membalik gambar kiri dan kanan alokasi stereo.

Jika anggota FlipOnNextVSync dari struktur DXGK_SETVIDPNSOURCEADDRESS_FLAGS diatur, driver 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 segera mulai memindai dari alokasi baru. Misalnya, jika driver memindai gambar yang tepat, itu memulai pemindaian baru dari offset relatif yang sama di 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 keempat dari anggota Nilai 32-bit (0x00000008).

[in] FlipStereoTemporaryMono

Didukung dimulai dengan Windows 8.

Menentukan apakah driver menggunakan gambar kiri alokasi stereo untuk bagian kanan dan kiri bingkai stereo. Driver melakukan operasi saat ini yang sama seperti dengan FlipStereo, kecuali bahwa ia 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 kelima dari anggota Nilai 32-bit (0x00000010).

[in] FlipStereoPreferRight

Didukung dimulai dengan Windows 8.

Menentukan bahwa ketika driver mengkloning alokasi utama stereo ke monitor mono, ia 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 keenam dari anggota Nilai 32-bit (0x00000020).

[in] SharedPrimaryTransition

Didukung dimulai dengan Windows 8.

Menentukan bahwa driver bertransisi ke atau dari alokasi utama terkelola bersama.

Anggota ini diatur jika salah satu transisi berikut terjadi:

Alokasi utama saat ini bukan alokasi utama bersama, tetapi yang baru.
Alokasi utama saat ini adalah alokasi utama bersama, tetapi yang baru tidak.

Ketika SharedPrimaryTransition diatur, driver miniport tampilan harus memvalidasi bahwa perangkat keras dapat dengan mulus beralih bolak-balik antara alokasi utama dan bersama, dan harus melakukan pemrograman perangkat keras apa pun yang diperlukan untuk membuat sakelar mulus terjadi.

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

[in] IndependentFlipExclusive

Didukung dimulai dengan Windows 10.

Ketika IndependentFlipExlusive diatur, flip dilakukan dalam mode eksklusif balik independen. Buffer depan hanya diakses oleh perangkat keras tampilan (bukan oleh DWM) dan driver mode kernel dapat menerapkan pengoptimalan terkait sinkronisasi vertikal.

[in] MoveFlip

Didukung dimulai dengan Windows 10.

Ketika MoveFlip diatur, driver diberi tahu untuk menggunakan status apa pun yang telah disimpan dari flip sebelumnya untuk mengonfigurasi permintaan pemindaian baru.

[in] Reserved

Anggota ini dicadangkan dan harus diatur ke nol. Mengatur anggota ini ke nol setara dengan mengatur 23 bit yang tersisa (0xFFFFFF00) dari anggota Nilai 32-bit ke nol.

Value

Anggota dalam serikat yang DXGK_SETVIDPNSOURCEADDRESS_FLAGS berisi yang dapat menyimpan nilai 32-bit yang mengidentifikasi jenis operasi.

Keterangan

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

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

Dimulai dengan Windows 8, driver miniport tampilan dapat gagal melakukan panggilan ke fungsi DxgkDdiSetVidPnSourceAddress, mengembalikan STATUS_INVALID_PARAMETER, ketika anggota SharedPrimaryTransition diatur dalamBenderapSetVidPnSourceAddress->. Namun, kegagalan seperti itu tidak diharapkan kecuali ada kesalahan dalam implementasi driver mode pengguna dari fungsi CheckDirectFlipSupport atau di Desktop Window Manager (DWM). Jika kegagalan seperti itu terjadi, sistem operasi tidak akan dengan mulus gagal kembali ke mode komposisi, dan presentasi akan salah.