Bagikan melalui

Membangun driver IddCx 1.4

  • Artikel

Karena perubahan yang dilakukan di IddCx 1.3 untuk Windows 10 versi 1809, driver tampilan tidak langsung (IDD) yang dibuat terhadap IddCx v1.4 dapat berjalan pada Windows 10 versi 1809 menggunakan pemeriksaan runtime untuk memverifikasi apakah perubahan DDI di IddCx 1.4 tersedia pada sistem tersebut. Lihat Membangun driver WDF untuk beberapa versi Windows untuk informasi selengkapnya.

Mulai dari IddCx 1.4, driver IddCx dapat dibuat untuk diinstal pada Windows 10, versi 1803 dan yang lebih baru dengan melakukan hal berikut. CATATAN: driver ini tidak akan dimuat pada Windows 10, versi 1607 hingga 1709.

  • Bangun dan tautkan driver menggunakan header dan pustaka IddCx 1.4 dari Windows Driver Kit (WDK).
  • Atur IDDCX_MINIMUM_VERSION_REQUIRED ke 3 di lingkungan build. Ini memberi tahu OS versi IddCx minimum tempat driver dibangun, 1.3 dalam hal ini.
  • Saat menginisialisasi struktur IddCx, gunakan makro XXX_INIT yang sesuai. Misalnya, gunakan makro IDD_CX_CLIENT_CONFIG_INIT() untuk menginisialisasi struktur IDD_CX_CLIENT_CONFIG. Makro menggunakan kode runtime untuk mengatur bidang Ukuran ke ukuran yang benar untuk versi IddCx yang dijalankan driver.
  • Gunakan makro IDD_IS_FIELD_AVAILABLE() untuk menentukan apakah struktur yang diteruskan ke driver dari IddCx memiliki bidang yang ditentukan. CATATAN: IddCx 1.4 tidak memperluas struktur yang ada yang diteruskan dari IddCx ke driver sehingga makro ini tidak perlu digunakan dalam IddCx 1.4.
  • Gunakan makro IDD_IS_FUNCTION_AVAILABLE() untuk menentukan apakah fungsi IddCx tertentu tersedia pada OS yang dijalankan driver. Misalnya, gunakan IDD_IS_FUNCTION_AVAILABLE(IddCxAdapterSetRenderAdapter) untuk menentukan apakah IddCxAdapterSetRenderAdapter() mendukung OS ini.

Tabel berikut ini meringkas versi IddCx yang didukung oleh rilis OS yang berbeda.

Versi OS Versi IddCx dikirim dengan OS Driver versi IddCx yang dapat berjalan
1607 (RS1) 1,0 1,0
1703 (RS2) 1,0 1,0
1709 (RS3) 1.2 1.0 dan 1.2
1803 (RS4) 01/03/2021 1.0-1.3 dan 1.4 di atas(*)
1809 (RS5) 01/03/2021 1.0-1.3 dan 1.4 di atas(*)
1903 (19H1) 1,4 1.0-1.3 dan 1.4 di atas(*)
1909 (19H2) 1,4 1.0-1.3 dan 1.4 di atas(*)
2004 (20H1) 1,4 1.0-1.3 dan 1.4 di atas(*)
T/A 1.6 1.0-1.3 dan 1.4 di atas(*)

* IddCx 1.4 ke atas IDD perlu menggunakan makro dinamis seperti IDD_IS_FUNCTION_AVAILABLE() untuk memutuskan pada runtime fungsi OS mana yang dapat dipanggilnya. Makro dinamis ini didefinisikan dalam iddcx.h.

Untuk mendukung semua versi Windows yang mungkin:

  • Tulis driver IddCx 1.0 untuk Windows 10, versi 1607 hingga 1709.
  • Tulis satu driver IddCx 1.4 atau lebih tinggi untuk Windows 10, versi 1803 dan yang lebih baru.