Stampinf-Befehlsoptionen

  • Artikel

Stampinf ist ein Befehlszeilentool, das allgemeine INF-Dateidirektiven aktualisiert.

Stampinf -f filename 
[-s section] 
[-d [date | *]] 
[-a [architecture]] 
[-c catalogfile]
[-v [time | *]]
[-k version] 
[-u version]
[-i path]
[-n]

Parameter

-f Dateiname
Gibt die zu verarbeitende INF- oder INX-Datei an.

-s Abschnitt
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".

-d [ Datum | \]
Gibt das Datum an, das in der INF DriverVer-Direktive geschrieben wird. Das Format für das Datum ist Monat/Datum/Jahr (z . B. -d 10/20/2011).

Um das aktuelle Datum zu verwenden, geben Sie ein Sternchen (*) mit diesem Parameter an.

Wenn der Parameter -d nicht angegeben oder ohne Optionen angegeben wird, 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.

-a [ Architektur ]
Gibt die Architekturzeichenfolge an, um die variable $ARCH$ zu ersetzen, die in INX-Dateien verwendet wird. Die variable $ARCH$ wird verwendet, um eine TargetOSVersion-Dekoration in einem ABSCHNITT DES INF Manufacturer und dessen jeweiligen Abschnittsnamen an eine bestimmte Plattform anzupassen. Weitere Informationen zur variablen $ARCH$ finden Sie unter Verwenden von INX-Dateien zum Erstellen von INF-Dateien.

Die Werte für die Architekturzeichenfolge sind x86, 64 (für Itanium-basierte Plattformen) und x64 (für amd64-Plattformen).

Wenn der Parameter -a nicht angegeben oder ohne Optionen angegeben wird, verwendet Stampinf den Wert, der von der Plattformumgebungsvariablen angegeben wird, die im Buildumgebungsfenster festgelegt ist.

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

-v [ Zeit | *]
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.

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

Wenn der Parameter "-v " nicht angegeben oder ohne Optionen angegeben wird, 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.

-k Version
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.

-u Version
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.

-n
Zeigt ausführliche Stampinf-Ausgabe an.

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

Kommentare

Der Datumswert, den Stampinf in die INF DriverVer-Direktive einfügt, basiert nicht auf koordinierter Weltzeit (COORDINATED Universal Time , UTC), die auch als Greenwich Mean Time bezeichnet wird. Inf2Cat interpretiert jedoch den Datumswert dieser INF-Direktive als UTC-Wert. Dies kann zu Fehlern führen, wenn der von Stampinf verwendete lokale Datumswert von Inf2Cat als UTC-Wert für das Datum von morgen interpretiert wird. Führen Sie eine der folgenden Aktionen aus, um dieses Problem zu vermeiden:

  • Legen Sie die STAMPINF_DATE Umgebungsvariable auf den entsprechenden UTC-Datumswert fest. Führen Sie jetzt Stampinf aus, ohne den Parameter -d anzugeben. Dadurch wird Stampinf angewiesen, den Datumswert zu verwenden, der von der STAMPINF_DATE Umgebungsvariable angegeben wird. Jetzt verwenden sowohl Stampinf als auch Inf2Cat UTC.
  • Ändern Sie die Projekteinstellungen für das Treiberpaket so, dass Inf2Cat festgelegt wird /uselocaltime. Verwenden Sie dazu Configuration Properties-Inf2Cat-General-Use>>> Local Time. Jetzt verwenden sowohl Stampinf als auch Inf2Cat die lokale Zeit.

Beim Entwickeln des Treibers können Sie die Umgebungsvariable PRIVATE_DRIVER_PACKAGE festlegen. Wenn diese Variable festgelegt ist, legt Stampinf unabhängig von den Befehlszeileneinstellungen das Datum und die Version fest, das für die INF DriverVer-Direktive verwendet wird, auf das aktuelle Datum und die aktuelle Uhrzeit. Darüber hinaus legt Stampinf die CatalogFile-Direktive fest. Stampinf schreibt CatalogFile=delta.cat im Abschnitt INF-Version, es sei denn, ein Katalog wurde bereits mit der Befehlsoption -c angegeben.

Geben Sie den folgenden Befehl in ein Buildfenster ein, um diesen Entwicklungsmodus zu aktivieren:

set PRIVATE_DRIVER_PACKAGE=1