enumerasi IDDCX_ADAPTER_FLAGS (iddcx.h)
IDDCX_ADAPTER_FLAGS menentukan bendera kemampuan Boolean untuk adaptor tampilan tidak langsung.
Sintaks
typedef enum IDDCX_ADAPTER_FLAGS {
IDDCX_ADAPTER_FLAGS_NONE = 0,
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE = 0x1,
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS = 0x2,
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER = 0x4,
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS = 0x8,
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION = 0x10,
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS = 0x20,
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 = 0x40,
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE = 0x80
} ;
Konstanta
IDDCX_ADAPTER_FLAGS_NONE Nilai: 0 Menunjukkan bahwa tidak ada bendera yang diatur untuk adaptor. |
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE Nilai: 0x1 Model tampilan tidak langsung secara otomatis mendukung mode virtual OS, memungkinkan OS untuk melakukan perubahan mode dengan lancar menggunakan penskalan Desktop Window Manager (DWM) per bingkai tanpa perubahan mode tampilan. Kerugian terjadi ketika mode desktop yang lebih kecil digunakan oleh pengguna: gambar desktop yang disediakan untuk driver lebih besar dari ukuran desktop, sehingga membuang-buang enkode dan mengirimkan bandwidth. Nilai enum ini memberi tahu OS untuk menggunakan ukuran permukaan desktop sekecil mungkin ketika mode desktop diubah. Solusi yang memiliki overhead pemrosesan besar atau bandwidth transmisi terbatas biasanya menggunakan bendera ini untuk mengurangi ukuran gambar desktop untuk memproses sebanyak mungkin. Pengaturan bendera ini menghasilkan perubahan mode setiap kali resolusi desktop diubah. |
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS Nilai: 0x2 Bendera ini tidak digunakan lagi mulai iddCx v1.7. Driver masih dapat mengatur bendera ini untuk IddCx 1.7 ke atas tetapi tidak akan berpengaruh. Jika driver dirancang untuk berjalan pada pre-IddCx 1.7 dan mengatur bendera ini, driver tersebut harus memiliki logika untuk memproses pemindahan; jika tidak, pengguna akan melihat masalah visual saat berjalan pada sistem pra-IddCx 1.7. Menunjukkan apakah driver dapat menggunakan wilayah pemindahan yang disediakan oleh OS selain rekam jentik kotor saat mengodekan gambar. Driver hanya boleh mengatur ini ke TRUE jika menggunakan wilayah pemindahan karena OS dikenakan biaya saat menghasilkan sumber daya tambahan ini. Jika driver mengatur ini ke FALSE, OS mengonversi semua wilayah pemindahan menjadi rect kotor. |
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER Nilai: 0x4 Menunjukkan apakah driver adalah driver sesi jarak jauh yang mendukung monitor sesi jarak jauh, bukan monitor sesi konsol. Driver sesi jarak jauh tidak dapat mendukung monitor sesi konsol, dan driver sesi konsol tidak dapat mendukung pemantauan sesi jarak jauh. Didukung mulai dari IddCx versi 1.4. |
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS Nilai: 0x8 Menunjukkan bahwa driver lebih suka memori yang berdampingan secara fisik untuk digunakan untuk buffer rantai pertukaran, memungkinkan driver untuk langsung memindai buffer tanpa perlu salinan perantara. Didukung mulai dari IddCx versi 1.6. |
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION Nilai: 0x10 Menunjukkan bahwa driver ingin menerima semua perubahan posisi kursor; artinya, ia ingin menerima kedua input mouse yang disuntikkan ke sesi jarak jauh dari klien jarak jauh dan gerakan prosedural yang disebabkan oleh panggilan API dari aplikasi atau OS di server. Bendera ini hanya valid jika dikombinasikan dengan IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER. IddCxAdapterInitAsync akan gagal jika IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION diatur tanpa IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER. Didukung mulai dari IddCx versi 1.7. |
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS Nilai: 0x20 Driver yang mengatur bendera ini meminta OS untuk melacak wilayah kotor pembaruan desktop secara lebih akurat. Pelacakan yang lebih akurat ini memiliki overhead penggunaan CPU yang kecil sehingga driver hanya boleh mengatur bendera ini jika wilayah kotor yang lebih kecil bermanfaat bagi driver. Didukung mulai dari IddCx versi 1.8. |
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 Menunjukkan bahwa driver dapat memproses permukaan swapchain IEEE half-precision floating point (FP16). Driver harus mengatur IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 bahkan untuk adaptor yang tidak mendukung HDR atau SDR WCG. OS mengirimkan permukaan dan mode HDR atau SDR WC ke driver ketika kombinasi monitor yang tepat, kemampuan target, pengaturan O, dan sebagainya sudah diberlakukan. Oleh karena itu, driver yang mengatur IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 juga harus mendukung fungsi IddCx versi 1.10 yang memungkinkan hal ini terjadi. Driver yang mendukung HDR10 harus mampu: * Menerima dan memproses permukaan format FP16 dalam swapchain. * Menerapkan tingkat putih SDR yang ditunjukkan ke kursor mouse. Driver konsol juga harus: * Gunakan transformasi warna matriks 3x4 baru. * Terima dan gunakan metadata HDR. Driver jarak jauh juga harus: * Pasokan colorimetry dan tingkat putih SDR jika diperlukan. Didukung mulai iddCx versi 1.10. Lihat Keterangan. |
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE Nilai: 0x80 Hanya driver jarak jauh yang dapat mengatur bendera ini. Driver jarak jauh dapat menggunakan IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE untuk memungkinkan mereka menentukan mode target yang bukan bagian dari deskriptor monitor. Biasanya OS memilih mode berdasarkan berada dalam daftar mode monitor dan target, dilaporkan baik melalui EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION atau EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES jika tidak ada deskriptor yang tersedia, dan daftar mode target. Skenario jarak jauh mungkin memerlukan mode yang tidak ada dalam deskriptor. Sebagai gantinya, driver dapat menggunakan mode target untuk menggambarkannya dan menunjukkan kepada OS bahwa mereka tidak boleh diperiksa terhadap mode monitor. Ketika driver jarak jauh menetapkan bendera ini, itu menunjukkan bahwa setiap mode target yang dilaporkan dalam panggilan ke EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 dan IddCxMonitorUpdateModes2 dijamin kompatibel dengan monitor yang saat ini terhubung. OS kemudian tidak akan memanggil EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 atau EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES. Didukung mulai iddCx versi 1.10. Lihat Keterangan. |
Keterangan
Untuk menentukan apakah OS menerima pengaturan driver IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 atau IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE, driver harus menggunakan makro IDD_IS_FUNCTION_AVAILABLE untuk memeriksa keberadaan salah satu DDI versi 1.10; misalnya IDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2)
. Makro ini mengevaluasi ke TRUE pada OS yang didukung v1.10 dan salah jika tidak. Lihat Updates untuk IddCx versi 1.10 dan yang lebih baru untuk informasi selengkapnya.
Persyaratan
Persyaratan | Nilai |
---|---|
Header | iddcx.h |