Using INX Files with UMDF Drivers

An INX file is an INF file that contains string variables that represent version information. When you build your driver using Microsoft Visual Studio, MSBuild.exe runs the Stampinf tool to replace the string variables in INX files with text strings that represent a specific hardware architecture or a framework version. For information about building drivers in Visual Studio, see Building a Driver.

If you create INX files for your drivers, you do not have to maintain multiple version-specific INF files. Instead, you can create a single INX file and use Stampinf to generate version-specific INF files when you need them.

To modify Stampinf properties within Visual Studio, open the Property Pages for your driver package project. Right-click the package project in Solution Explorer and select Properties. In the Property Pages for the package, click Configuration Properties, and then StampInf.

The WDK includes INX files for all the UMDF sample drivers. You can also manually run the Stampinf tool, which is located in the bin subdirectory of the WDK.

Suppose an INX file has the following code:


[Manufacturer]
%MSFTUMDF%=Microsoft,NT$ARCH$

After the MSBuild utility generates the INF file, the NT$ARCH$ extension becomes NTx86 for an x86-based hardware platform as the following code example shows:


[Manufacturer]
%MSFTUMDF%=Microsoft,NTx86

You should specify the UMDF library version and the UMDF co-installer version in your driver's INX file as the following code example shows:


[SourceDisksFiles]
WudfUpdate_$UMDFCOINSTALLERVERSION$.dll=1

[UMDFYourDriver_Install]
UmdfLibraryVersion=$UMDFVERSION$

[CoInstallers_CopyFiles]
WudfUpdate_$UMDFCOINSTALLERVERSION$.dll

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

For more information about how to use Stampinf.exe and makefile.inc files, see the WDK sample drivers that use UMDF. These sample drivers are located in the \src\umdf subdirectory of the WDK.

 

 

Send comments about this topic to Microsoft

Build date: 4/1/2013

Show: