Rediger

Del via

Using INX Files to Create INF Files

  • Artikkel

When writing a Windows driver, you can create a single INX file instead of multiple version-specific INF files. Use Microsoft Visual Studio or the Stampinf tool to generate the version-specific INF files as needed.

An INX file is like an INF file, but it contains string variables that represent version information.

When you build your driver using Visual Studio, the build process runs Stampinf to replace the string variables in INX files with text strings that represent a specific hardware architecture or a framework version. You can also manually run Stampinf, which is located in the bin subdirectory of the WDK.

Configuring the INX file path in Visual Studio

When building a driver in Visual Studio, it's essential to verify that the project shows the correct location of the INX file to avoid errors such as The specified task executable 'stampinf.exe' could not be run.. Follow these steps to ensure the INX file path is correctly set:

  1. Launch Visual Studio and open your driver project.
  2. Right-click on the project in the Solution Explorer and select Properties.
  3. Select the Build tab.
  4. In the Output section, ensure that the path to the INX file is correctly specified. If the path is incorrect or missing, update it to the correct location where your INX file is stored.
  5. Ensure that the Stampinf tool (Stampinf.exe) is installed and accessible in your build environment. This tool is responsible for processing INX files during the build process.

If you encounter a FileNotFoundException error, double-check the INX file path and verify that the Stampinf tool can be executed without errors.

Updating Stampinf properties

To modify Stampinf properties within Visual Studio:

  1. Open the Property Pages for your driver package project.
  2. Right-click the package project in Solution Explorer and select Properties.
  3. In the Property Pages for the package, select Configuration Properties, and then StampInf.

The WDK includes INX files for all the KMDF and UMDF sample drivers.

String variables for INX files

You can use the following string variables in an INX file:

$ARCH$

    Stampinf replaces this variable with an architecture-specific string. For example, if you're using an x86 build environment, the tool replaces $ARCH$ with "x86". You can use the $ARCH$ string wherever you need to specify a specific architecture within an INF file, such as within an [**INF Manufacturer section**](../install/inf-manufacturer-section.md), as follows: 
    [Manufacturer]
%StdMfg%=Standard,NT$ARCH$

$KMDFCOINSTALLERVERSION$

    If you use the [Stampinf](../devtest/stampinf.md) tool's -*k* option, Stampinf replaces this variable with a string that represents a specific version of the KMDF co-installer. You can use the $KMDFCOINSTALLERVERSION$ variable when you specify the framework's co-installer within an INF file, such as within an [**INF DDInstall.CoInstallers section**](../install/inf-ddinstall-coinstallers-section.md), as follows: 
    [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$

    If you set the **KMDF Version Number** property in Visual Studio (or use the [Stampinf](../devtest/stampinf.md) tool's -*k* option), Stampinf replaces this variable with a string that represents a specific version of KMDF. You can use the $KMDFVERSION$ variable when you specify the framework's version within an INF file, such as when you specify the [KmdfLibraryVersion](installing-the-framework-s-co-installer.md) directive, as follows: 
    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 also supports a -u option to replace UMDF string variables in an INX file. If your driver package includes both UMDF-based drivers and KMDF-based drivers, you can use the -k and -u options with a single Stampinf command and a single INX file.