Menggunakan File INX untuk Membuat File INF

  • Artikel

Saat Anda menulis driver Windows, alih-alih mempertahankan beberapa file INF khusus versi, Anda dapat membuat satu file INX dan menggunakan Microsoft Visual Studio atau alat Stampinf untuk menghasilkan file INF khusus versi saat Anda membutuhkannya.

File INX seperti file INF, tetapi berisi variabel string yang mewakili informasi versi.

Saat Anda membangun driver menggunakan Visual Studio, proses build menjalankan Stampinf untuk mengganti variabel string dalam file INX dengan string teks yang mewakili arsitektur perangkat keras tertentu atau versi kerangka kerja. Anda juga dapat menjalankan Stampinf secara manual, yang terletak di subdirektori bin WDK.

Untuk mengubah properti Stampinf dalam Visual Studio:

  1. Buka Halaman Properti untuk proyek paket driver Anda.
  2. Klik kanan proyek paket di Penjelajah Solusi dan pilih Properti.
  3. Di Halaman Properti untuk paket, klik Properti Konfigurasi, lalu StampInf.

WDK mencakup file INX untuk semua driver sampel KMDF dan UMDF.

Anda dapat menggunakan variabel string berikut dalam file INX:

$ARCH$

    Stampinf mengganti variabel ini dengan string khusus arsitektur. Misalnya, jika Anda menggunakan lingkungan build x86, alat ini mengganti $ARCH$ dengan "x86". Anda dapat menggunakan string $ARCH$ di mana pun Anda perlu menentukan arsitektur tertentu dalam file INF, seperti dalam bagian [**Produsen INF**](.. . /install/inf-manufacturer-section.md), sebagai berikut:
    [Manufacturer]
%StdMfg%=Standard,NT$ARCH$

$KMDFCOINSTALLERVERSION$

    Jika Anda menggunakan [Stampinf](.. Opsi alat /devtest/stampinf.md) -*k*, Stampinf mengganti variabel ini dengan string yang mewakili versi tertentu dari penginstal bersama KMDF. Anda dapat menggunakan variabel $KMDFCOINSTALLERVERSION$ saat menentukan penginstal bersama kerangka kerja dalam file INF, seperti dalam bagian [**INF DDInstall.CoInstallers**](.. . /install/inf-ddinstall-coinstallers-section.md), sebagai berikut:
    [ECHO_Device.NT.CoInstallers]
AddReg=ECHO_Device_CoInstaller_AddReg
CopyFiles=ECHO_Device_CoInstaller_CopyFiles

[ECHO_Device_CoInstaller_AddReg]
HKR,,CoInstallers32,0x00010000, "WdfCoInstaller$KMDFCOINSTALLERVERSION$.dll,WdfCoInstaller"

[ECHO_Device_CoInstaller_CopyFiles]
WdfCoInstaller$KMDFCOINSTALLERVERSION$.dll

$KMDFVERSION$

    Jika Anda mengatur properti **Nomor Versi KMDF** di Visual Studio (atau gunakan [Stampinf](.. Opsi alat /devtest/stampinf.md) -*k*), Stampinf mengganti variabel ini dengan string yang mewakili versi KMDF tertentu. Anda dapat menggunakan variabel $KMDFVERSION$ saat menentukan versi kerangka kerja dalam file INF, seperti saat Anda menentukan direktif [KmdfLibraryVersion](installing-the-framework-s-co-installer.md), sebagai berikut:
    KmdfLibraryVersion = $KMDFVERSION$

$UMDFCOINSTALLERVERSION$

    [SourceDisksFiles] WudfUpdate_$UMDFCOINSTALLERVERSION$.dll=1
    [CoInstallers_CopyFiles] WudfUpdate_$UMDFCOINSTALLERVERSION$.dll
    

    [CoInstallers_AddReg]
HKR,,CoInstallers32,0x00010000,"WUDFUpdate_$UMDFCOINSTALLERVERSION$.dll"

$UMDFVERSION$

    [UMDFYourDriver_Install]
UmdfLibraryVersion=$UMDFVERSION$

Stampinf juga mendukung opsi -u untuk mengganti variabel string UMDF dalam file INX. Jika paket driver Anda mencakup driver berbasis UMDF dan driver berbasis KMDF, Anda dapat menggunakan opsi -k dan -u dengan satu perintah Stampinf dan satu file INX.