Stampinf-Eigenschaften für Treiberprojekte

  • Artikel

Legt die Eigenschaften für das Stampinf-Tool fest. Sie können Stampinf verwenden, um allgemeine INF- und INX-Dateidirektiven beim Erstellen des Treibers zu aktualisieren.

Festlegen von Stampinf-Eigenschaften für Treiberprojekte

  1. Öffnen Sie die Eigenschaftsseiten für Ihr Treiberprojekt. Wählen Sie das Treiberprojekt in Projektmappen-Explorer aus und halten Sie es gedrückt (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie "Eigenschaften" aus.
  2. Wählen Sie auf den Eigenschaftenseiten für das Treiberprojekt Konfigurationseigenschaften und dann Stampinf aus.
  3. Legen Sie die Eigenschaften für das Projekt fest.

Wenn Sie diese Eigenschaftenseite zu Ihrem Projekt hinzufügen möchten, damit Sie den Stampinf während des Buildvorgangs ausführen können, lesen Sie die WDK- und Visual Studio-Buildumgebung und die Stampinf-Aufgabe.

Option "Stampinf" Beschreibung

Architektur aktivieren

Aktiviert die Ersetzung der variablen $ARCH$, die in INX-Dateien verwendet wird. Wenn diese Option aktiviert ist, wird der für Architektur angegebene Wert verwendet. Wenn "Nein" angegeben ist, wird die variable $ARCH$ entfernt. Beispielsweise wird "Standard.NT$ARCH$" zu "Standard.NT".

Aufbau

Gibt die Architekturzeichenfolge an, um die variable $ARCH$ zu ersetzen, die in INX-Dateien verwendet wird. Der Standardwert ist $(InfArch), ein Makro, das die aktuelle aktive Konfiguration in Visual Studio auswählt. Mögliche Werte sind x86, x64. Diese Einstellung entspricht der Angabe der Stampinf-Option -a [architecture].

VersionStamp aktivieren

Aktiviert den Versionszeitstempel. Wenn diese Option aktiviert ist, darf die Treiberversionsnummer nicht leer sein. Die Treiberversionsnummer gibt die Uhrzeit an, die in der INF DriverVer-Direktive für die Versionsnummer geschrieben wird. Wenn sie nicht aktiviert ist, lesen Sie die Beschreibung des Standardverhaltens für diese Option unter "Treiberversionsnummer".

Treiberversionsnummer

Gibt die Uhrzeit an, die in der INF DriverVer-Direktive für die Versionsnummer geschrieben wird. Das Format für die Uhrzeit lautet "hours.minutes.seconds.millisekunden " (z. B. 11.30.20.15). Diese Option ist während der Entwicklung nützlich, da sie eine bequeme Möglichkeit bietet, die Versionsnummer des Treibers zu erhöhen. Diese Einstellung entspricht der Angabe der Stampinf-Option -v [ Time| ].

Um die aktuelle Uhrzeit zu verwenden, geben Sie ein Sternchen () mit diesem Parameter an.

Standardverhalten:

Wenn die Versionsnummer des Treibers nicht angegeben ist oder "VersionStamp aktivieren" nicht angegeben ist, verwendet Stampinf einen der folgenden Versionsnummernwerte:

  • Wenn die STAMPINF_VERSION Umgebungsvariable festgelegt ist, verwendet Stampinf den Durch diese Umgebungsvariablen angegebenen Versionsnummernwert.

  • Wenn die STAMPINF_VERSION Umgebungsvariable nicht angegeben ist, extrahiert Stampinf die Versionsnummer aus der Datei ntverp.h.

Hinweis : Standardmäßig wird die STAMPINF_VERSION Umgebungsvariable nicht festgelegt, wenn Sie einen Treiber erstellen, es sei denn, Sie legen sie als Systemumgebungsvariable fest. Informationen zum Angeben dieser Umgebungsvariablen in der Visual Studio-Buildumgebung finden Sie unter How to: Use Environment Variables in a Build.

DateStamp aktivieren

Aktiviert den Datumsstempel. Wenn diese Option aktiviert ist, darf das Datum der Treiberversionsrichtlinie nicht leer sein. Wenn diese Option nicht aktiviert ist, lesen Sie die Beschreibung des Standardverhaltens für diese Option unter Dem Datum der Treiberversionsrichtlinie.

Datum der Treiberversionsrichtlinie

Gibt das Datum an, das in der INF DriverVer-Direktive geschrieben wird. Das Format für das Datum ist das Monatsdatumsjahr// (z. B. 10.20.2011).

Wenn Sie das aktuelle Datum verwenden möchten, geben Sie ein Sternchen () mit diesem Parameter an.

Standardverhalten:

Wenn der Parameter "Datum der Treiberversionsrichtlinie" nicht angegeben ist oder "DateStamp enable DateStamp" nicht angegeben ist, verwendet Stampinf einen der folgenden Datumswerte:

  • Wenn die STAMPINF_DATE Umgebungsvariable festgelegt ist, verwendet Stampinf den Datumswert, der von dieser Umgebungsvariable angegeben wird.

  • Wenn die STAMPINF_DATE Umgebungsvariable nicht angegeben ist, verwendet Stampinf das aktuelle Datum.

Diese Einstellung entspricht der Angabe der Stampinf-Option -d [date|].

Hinweis : Standardmäßig wird die STAMPINF_DATE Umgebungsvariable nicht festgelegt, wenn Sie einen Treiber erstellen, es sei denn, Sie legen sie als Systemumgebungsvariable fest. Informationen zum Angeben dieser Umgebungsvariablen in der Visual Studio-Buildumgebung finden Sie unter How to: Use Environment Variables in a Build.

Abschnitt "Treiberversionsdirektive"

Gibt den INF-Abschnitt an, in dem die INF DriverVer-Direktive platziert werden soll. Der Standardspeicherort für diese Direktive ist der Abschnitt "INF-Version".

Diese Einstellung entspricht dem Angeben des Abschnitts "Stampinf"-Option -s.

KMDF-Versionsnummer

Gibt die Version von KMDF an, von der dieser Treiber abhängt. Dies wird verwendet, um den KmdfLibraryVersion- und KMDF-Koinstallationsnamen in der INF-Datei anzupassen. Diese Option ersetzt die Schlüsselwörter $KMDFVERSION$ und $KMDFCOINSTALLERVERSION$ in der INF-Datei. Die Zeichenfolge weist das folgende Format auf:

<>major_version.<minor_version>

Wenn Sie z. B. 1,5 als Versionszeichenfolge angeben, werden die Werte 1,5 und 01005 für die beiden Schlüsselwörter (bzw. ) verwendet.

Diese Einstellung entspricht der Angabe der Stampinf-Option -k KMDFversion.

UMDF-Versionsnummer

Gibt die Version von UMDF an, von der dieser Treiber abhängt. Diese Option wird verwendet, um den UmdfLibraryVersion- und UMDF-Co-Installer-Namen in der INF-Datei anzugeben. Die angegebene Version ersetzt die Schlüsselwörter $UMDFVERSION$ und $UMDFCOINSTALLERVERSION$ in der INF-Datei. Die Versionszeichenfolge weist das folgende Format auf:

<>major_version.<>minor_version.<service_version>

(wobei <> service_version ist in der Regel Null).

Wenn Sie z. B. "1.5.0" als Versionszeichenfolge angeben, werden die Werte 1.5.0 und 01005 für die Haupt- bzw. Nebenstichwörter verwendet.

Diese Einstellung entspricht der Angabe der Stampinf-Option -u UMDFversion.

Katalogdateiname

Gibt den Wert an, der in der CatalogFile-Direktive im ABSCHNITT "INF-Version" geschrieben wird. Standardmäßig ist die CatalogFile-Direktive nicht geschrieben.

Diese Einstellung entspricht der Angabe der Stampinf-Option -c catalogfile.

Ausführlich

Zeigt ausführliche Stampinf-Ausgabe an.

Diese Einstellung entspricht der Angabe der Stampinf-Option -n.

Versionsheaderpfad

Gibt den Speicherort der Datei Ntverp.h an. Der Pfad stellt den vollqualifizierten Speicherort des Verzeichnisses dar, das Ntverp.h enthält.

Diese Einstellung entspricht der Angabe der Stampinf-Option -i Path.