Verwenden von INX-Dateien zum Erstellen von INF-Dateien

  • Artikel

Wenn Sie einen Windows-Treiber schreiben, können Sie nicht mehrere versionsspezifische INF-Dateien verwalten, sondern eine einzelne INX-Datei erstellen und microsoft Visual Studio oder das Stampinf-Tool verwenden, um bei Bedarf versionsspezifische INF-Dateien zu generieren.

Eine INX-Datei ähnelt einer INF-Datei, enthält aber Zeichenfolgenvariablen, die Versionsinformationen darstellen.

Wenn Sie Ihren Treiber mit Visual Studio erstellen, führt der Buildprozess Stampinf aus, um die Zeichenfolgenvariablen in INX-Dateien durch Textzeichenfolgen zu ersetzen, die eine bestimmte Hardwarearchitektur oder eine Frameworkversion darstellen. Sie können Stampinf auch manuell ausführen, das sich im Unterverzeichnis bin des WDK befindet.

So ändern Sie Stampinf-Eigenschaften in Visual Studio:

  1. Öffnen Sie die Eigenschaftenseiten für Ihr Treiberpaketprojekt.
  2. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Paketprojekt, und wählen Sie Eigenschaften aus.
  3. Klicken Sie auf den Eigenschaftenseiten für das Paket auf Konfigurationseigenschaften und dann auf StampInf.

Der WDK enthält INX-Dateien für alle KMDF- und UMDF-Beispieltreiber.

Sie können die folgenden Zeichenfolgenvariablen in einer INX-Datei verwenden:

$ARCH$

    Stampinf ersetzt diese Variable durch eine architekturspezifische Zeichenfolge. Wenn Sie beispielsweise eine x86-Buildumgebung verwenden, ersetzt das Tool $ARCH$ durch "x86". Sie können die $ARCH$-Zeichenfolge überall dort verwenden, wo Sie eine bestimmte Architektur innerhalb einer INF-Datei angeben müssen, z. B. in einem [**INF-Abschnitt Manufacturer**](.). /install/inf-manufacturer-section.md) wie folgt:
    [Manufacturer]
%StdMfg%=Standard,NT$ARCH$

$KMDFCOINSTALLERVERSION$

    Wenn Sie die [Stampinf](.. Die Option -*k* des Tools /devtest/stampinf.md) ersetzt diese Variable durch eine Zeichenfolge, die eine bestimmte Version des KMDF-Co-Installers darstellt. Sie können die Variable $KMDFCOINSTALLERVERSION$ verwenden, wenn Sie den Co-Installer des Frameworks in einer INF-Datei angeben, z. B. in einem [**INF DDInstall.CoInstallers-Abschnitt**](.). /install/inf-ddinstall-coinstallers-section.md) wie folgt:
    [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$

    Wenn Sie die Eigenschaft **KMDF-Versionsnummer** in Visual Studio festlegen (oder die [Stampinf](.. /devtest/stampinf.md) -*k*-Option) des Tools). Stampinf ersetzt diese Variable durch eine Zeichenfolge, die eine bestimmte Version von KMDF darstellt. Sie können die Variable $KMDFVERSION$ verwenden, wenn Sie die Version des Frameworks in einer INF-Datei angeben, z. B. wenn Sie die [KmdfLibraryVersion](installing-the-framework-s-co-installer.md)-Direktive wie folgt angeben:
    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 unterstützt auch eine -u-Option zum Ersetzen von UMDF-Zeichenfolgenvariablen in einer INX-Datei. Wenn Ihr Treiberpaket sowohl UMDF-basierte Treiber als auch KMDF-basierte Treiber enthält, können Sie die Optionen -k und -u mit einem einzelnen Stampinf-Befehl und einer einzelnen INX-Datei verwenden.