Edit

Stampinf task

  • Article

The Windows Driver Kit (WDK) provides the StampInf task so that you can run the stampinf.exe tool when you build your driver using MSBuild. For information about the stampinf.exe tool, see Stampinf.

The Inf Item sends the parameters for the StampInf task. The item metadata for stampinf is accessed by using the Inf item in project files.

The following example shows how the edit metadata in the .vcxproj file.

<ItemGroup>
    <Inf Include="a.inf">
      <SpecifyArchitecture>true</SpecifyArchitecture>
      <Architecture>x86</Architecture>
    </Inf>
    <Inf Include="b.inf">
      <SpecifyArchitecture>false</SpecifyArchitecture>
      <Architecture>amd64</Architecture>
    </Inf>
</ItemGroup>

The following example shows the command-line invocation:

stampinf.exe –a "x86" a.inf
stampinf.exe b.inf

In the example above, MSBuild invokes stampinf.exe on both a.inf and b.inf, but with different sets of parameters. In the case of b.inf, even though the Architecture metadata is specified, the SpecifyArchitecture metadata is set to false. Therefore, the –a switch is not enabled on the command line. If you set this metadata to TRUE, then it will enable –a amd64 on the command line. In this way, you can just toggle this metadata and not have to edit the architecture metadata itself.

StampInf Task Parameter Item Metadata Tool Switch
Source

Required ITaskItem parameter. Specifies a list of source files.

 %(Inf.OutputPath)%(Inf.FileName).inf -f[source]
SpecifyArchitecture

This will enable the -a switch if set to true.

 %(Inf.SpecifyArchitecture)
Architecture

Optional string parameter. Specifies the target platform architecture.

 %(Inf.Architecture) -a[architecture]
CatalogFile

Optional string parameter. Specifies the catalog file directive in the INF version section.

 %(Inf.CatalogFileName) -c<catalogFile>
SpecifyDriverVerDirectiveDate

This will enable the –d switch if set to true.

 %(Inf.SpecifyDriverVerDirectiveDate)
DriverVerDirectiveDate

Optional string

 %(Inf.DateStamp) -d[date|]
DriverVerDirectiveSection

Optional string parameter. Specifies the INF section in which the INF DriverVer directive should be placed.

 %(Inf.DriverVersionSectionName) -s
SpecifyDriverVerDirectiveVersion

This will enable the –v switch if set to true.

 %(Inf.SpecifyDriverDirectiveVersion)
DriverVerDirectiveVersion

Optional string parameter. Specifies the version number in the driver directive.

 %(Inf.TimeStamp) -v[time|]
KmdfVersion

Optional string parameter. Specifies the version of KMDF that this driver depends on.

 %(Inf.KmdfVersionNumber) -k<version>
MinimalRebuildFromTracking

Optional Boolean parameter. If true, a tracked incremental build is performed. Otherwise, a rebuild is performed.

 %(Inf.MinimalRebuildFromTracking)
ToolPath

Optional string parameter. Allows you to specify the full path to the folder where the tool is located.

 $(StampInfToolPath)
TrackerLogDirectory

Optional string parameter. Specifies a log directory for tracker to write tlogs.

 %(Inf.StampInfTrackerLogDirectory)
TrackFileAccess

Optional Boolean parameter. If true, tracks file access patterns for this task.

 $(TrackFileAccess)
UmdfVersion

Optional string parameter. Specifies the version of UMDF that this driver depends on.

 %(Inf.UmdfVersionNumber) -u<version>
Verbosity

Optional Boolean parameter. Enables the verbosity of Stampinf output.

 %(Inf.EnableVerbose) -n