EVT_IDD_CX_ADAPTER_COMMIT_MODES2 fungsi panggilan balik (iddcx.h)

Artikel
02/29/2024

OS memanggil EVT_IDD_CX_ADAPTER_COMMIT_MODES2 untuk memberi tahu driver tentang perubahan mode untuk monitor pada adaptor.

Sintaks

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 EvtIddCxAdapterCommitModes2;

NTSTATUS EvtIddCxAdapterCommitModes2(
  IDDCX_ADAPTER AdapterObject,
  const IDARG_IN_COMMITMODES2 *pInArgs
)
{...}

Parameter

AdapterObject

[in] Objek adaptor yang dihasilkan OS dari adaptor yang sedang dikueri. Handel objek IDDCX_ADAPTER ini dikembalikan dalam panggilan sebelumnya ke IddCxAdapterInitAsync.

pInArgs

[in] Penunjuk ke struktur IDARG_IN_COMMITMODES2 yang berisi argumen yang digunakan oleh EVT_IDD_CX_ADAPTER_COMMIT_MODES2.

Nilai kembali

EVT_IDD_CX_ADAPTER_COMMIT_MODES2 mengembalikan nilai NTSTATUS . Jika operasi berhasil, operasi mengembalikan STATUS_SUCCESS atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, kode kesalahan NTSTATUS akan ditampilkan.

Keterangan

Ketika mode diterapkan untuk monitor, driver IddCx versi 1.10 yang mendukung HDR atau WCG dipanggil melalui fungsi ini dan memberi tahu ruang warna dan bit per komponen untuk digunakan pada koneksi monitor fisik. Nilai-nilai ini didasarkan pada kemampuan target dan parameter mode yang sebelumnya dilaporkan oleh driver. Melaporkan dukungan adapter untuk FP16 tetapi tidak mengekspos fungsi ini adalah kesalahan.

Ruang warna yang ditentukan dalam mode berkomitmen tidak menentukan format permukaan yang digunakan untuk setiap permukaan dalam swapchain. Permukaan yang disediakan dalam IDDCX_METADATA2 masih harus dikueri.

OS selalu menyediakan IDDCX_PATH2 untuk setiap monitor yang terhubung meskipun monitor tersebut tidak aktif, dan menunjukkan jalur mana yang telah berubah. Jika jalur ditandai tidak aktif, maka seluruh alur tampilan untuk jalur tersebut akan dimatikan dan tidak ada sinyal yang akan dikirim ke monitor.

Ketika jalur baru diterapkan, driver harus memprogram alur tampilan untuk menampilkan gambar hitam sampai bingkai pertama siap ditampilkan. Untuk mencapai hal ini, visibilitas WDDM harus mati hingga bingkai pertama siap ditampilkan, maka visibilitas harus diaktifkan.

Untuk informasi selengkapnya tentang dukungan HDR, lihat Pembaruan IddCx versi 1.10.