Edit

Stampinf Properties for Driver Projects

  • Article

Sets the properties for the Stampinf tool. You can use Stampinf to update common INF and INX file directives when you build the driver.

Setting Stampinf properties for driver projects

  1. Open the property pages for your driver project. Select and hold (or right-click) the driver project in Solution Explorer and select Properties.
  2. In the property pages for the driver project, select Configuration Properties and then select Stampinf.
  3. Set the properties for the project.

If you want to add this property page to your project, so that you can run the Stampinf during the build process, see the WDK and Visual Studio build environment and the Stampinf task.

Stampinf option Description

Enable Architecture

Enables the replacement of the $ARCH$ variable used in INX files. If enabled, the value specified for Architecture is used. If No is specified, the $ARCH$ variable is removed. For example, "Standard.NT$ARCH$" becomes "Standard.NT".

Architecture

Specifies the architecture string to replace the $ARCH$ variable that is used in INX files. The default value is $(InfArch), a macro that selects the current active configuration in Visual Studio. Possible values include x86, x64. This setting is equivalent to specifying the Stampinf option -a [architecture].

Enable VersionStamp

Enables the version time stamp. If enabled, the Driver Version Number must not be empty. The Driver Version Number specifies the time that is written in the INF DriverVer directive for the version number. If not enabled, see the description of the default behavior for this option under Driver Version Number.

Driver Version Number

Specifies the time that is written in the INF DriverVer directive for the version number. The format for the time is hours.minutes.seconds.milliseconds (for example, 11.30.20.15). This option is useful during development because it provides a convenient way to increase the version number of the driver. This setting is equivalent to specifying the Stampinf option -v [ time | ].

To use the current time, specify an asterisk () with this parameter.

Default behavior:

If the Driver Version Number is not specified, or if Enable VersionStamp is No or unspecified, Stampinf uses one of the following version number values:

  • If the STAMPINF_VERSION environment variable is set, Stampinf uses the version number value that is specified by this environment variable.

  • If the STAMPINF_VERSION environment variable is not specified, Stampinf extracts the version number from the ntverp.h file.

Note By default, the STAMPINF_VERSION environment variable is not set when you build a driver unless you set it as a system environment variable. To specify this environment variable within the Visual Studio build environment, see How to: Use Environment Variables in a Build.

Enable DateStamp

Enables the date stamp. If enabled, the Driver Version Directive Date must not be empty. If not enabled, see the description of the default behavior for this option under Driver Version Directive Date.

Driver Version Directive Date

Specifies the date that is written in the INF DriverVer directive. The format for the date is month/date/year (for example, 10/20/2011).

To use the current date, specify an asterisk () with this parameter.

Default behavior:

If the Driver Version Directive Date parameter is not specified, or if Enable DateStamp is No or unspecified, Stampinf uses one of the following date values:

  • If the STAMPINF_DATE environment variable is set, Stampinf uses the date value that is specified by this environment variable.

  • If the STAMPINF_DATE environment variable is not specified, Stampinf uses the current date.

This setting is equivalent to specifying the Stampinf option -d [date|].

Note By default, the STAMPINF_DATE environment variable is not set when you build a driver unless you set it as a system environment variable. To specify this environment variable within the Visual Studio build environment, see How to: Use Environment Variables in a Build.

Driver Version Directive Section

Specifies the INF section in which to put the INF DriverVer directive. The default location for this directive is the INF Version section.

This setting is equivalent to specifying the Stampinf option -s section.

KMDF Version Number

Specifies the version of KMDF that this driver depends on. This is used to customize the KmdfLibraryVersion and KMDF co-installer name in the INF file. This option replaces the $KMDFVERSION$ and $KMDFCOINSTALLERVERSION$ keywords in the INF file. The string has the following format:

<major_version>.<minor_version>

For example, if you specify 1.5 as the version string, the values 1.5 and 01005 are used for the two keywords (respectively).

This setting is equivalent to specifying the Stampinf option -k KMDFversion.

UMDF Version Number

Specifies the version of UMDF that this driver depends on. This option is used to specify the UmdfLibraryVersion and UMDF co-installer name in the INF file. The version that is specified replaces the $UMDFVERSION$ and $UMDFCOINSTALLERVERSION$ keywords in the INF file. The version string has the following format:

<major_version>.<minor_version>.<service_version>

(where <service_version> is typically zero).

For example, if you specify 1.5.0 as the version string, the values 1.5.0 and 01005 are used for the major and minor keywords (respectively).

This setting is equivalent to specifying the Stampinf option -u UMDFversion.

Catalog File Name

Specifies the value that is written in the CatalogFile directive in the INF Version section. By default, the CatalogFile directive is not written.

This setting is equivalent to specifying the Stampinf option -c catalogfile.

Verbose

Shows verbose Stampinf output.

This setting is equivalent to specifying the Stampinf option -n .

Version Header Path

Specifies the location of Ntverp.h file. The path represent the fully qualified location of the directory containing Ntverp.h.

This setting is equivalent to specifying the Stampinf option -i path.