Abschnitt "INF-Version"
Gemäß Konvention wird der Abschnitt Version zuerst in INF-Dateien angezeigt. Jede INF-Datei muss über diesen Abschnitt verfügen.
[Version]
Signature="signature-name"
[Class=class-name]
[ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn}]
[Provider=%INF-creator%]
[ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}]
[LayoutFile=filename.inf [,filename.inf]... ] (Windows 2000 and Windows XP)
[CatalogFile=filename.cat]
[CatalogFile.nt=unique-filename.cat]
[CatalogFile.ntx86=unique-filename.cat]
[CatalogFile.ntia64=unique-filename.cat] (Windows XP and later versions of Windows)
[CatalogFile.ntamd64=unique-filename.cat] (Windows XP and later versions of Windows)
[CatalogFile.ntarm=unique-filename.cat] (Windows 8 and later versions of Windows)
[CatalogFile.ntarm64=unique-filename.cat] (Windows 10 version 1709 and later versions of Windows)
DriverVer=mm/dd/yyyy,w.x.y.z
[PnpLockDown=0|1] (Windows Vista and later versions of Windows)
[DriverPackageDisplayName=%driver-package-description%]
[DriverPackageType=PackageType]
Einträge
Signature="signature-name"
Muss $Windows NT$ oder $Chicago$ sein. Dies gibt die Betriebssysteme an, für die dieser INF gültig ist. Diese Signaturwerte haben die folgende Bedeutung.
| Signaturwert | Bedeutung |
|---|---|
| $Windows NT$ | Alle Windows-Betriebssysteme |
| $Chicago$ | Alle Windows-Betriebssysteme |
Die einschließenden Dollarzeichen ($) sind erforderlich, aber bei diesen Zeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet. Wenn signature-name keiner dieser Zeichenfolgenwerte ist, wird die Datei nicht als gültige INF akzeptiert.
Im Allgemeinen unterscheidet Windows nicht zwischen diesen Signaturwerten. Einer von ihnen muss angegeben werden, aber es spielt keine Rolle, welche. Sie sollten den entsprechenden Wert angeben, damit ein Benutzer, der eine INF-Datei liest, die Betriebssysteme bestimmen kann, für die er vorgesehen ist.
Einige Klasseninstallationsprogramme stellen zusätzliche Anforderungen an die Angabe des Signaturwerts. Solche Anforderungen, sofern vorhanden, werden in den gerätetypspezifischen Abschnitten dieses Windows Driver Kit (WDK) erläutert.
Ein INF muss betriebssystemspezifische Installationsinformationen bereitstellen, indem systemdefinierte Erweiterungen an seine DDInstall-Abschnitte angefügt werden, unabhängig davon, ob der Signaturname$Windows NT$ oder $Chicago$ lautet. (Eine Erläuterung dieser Erweiterungen finden Sie unter Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme .)
Class=class-name
Für jeden Standardgerätetyp gibt dies den Namen der Gerätesetupklasse für den Gerätetyp an, der mithilfe dieser INF-Datei installiert wird. Dieser Name ist in der Regel einer der systemdefinierten Klassennamen, z. B. Net oder Display, die in Devguid.h aufgeführt sind. Weitere Informationen finden Sie unter Vom System bereitgestellte Gerätesetupklassen.
Wenn ein INF eine Klasse angibt, sollte er auch den entsprechenden systemdefinierten GUID-Wert für den ClassGUID-Eintrag angeben. Die Angabe des übereinstimmenden GUID-Werts für ein Gerät einer beliebigen vordefinierten Gerätesetupklasse kann das Gerät und seine Treiber schneller installieren, da dies dem Systemeinrichtungscode hilft, seine INF-Suche zu optimieren.
Wenn ein INF dem System eine neue Setupklasse von Geräten hinzufügt, sollte es einen eindeutigen Klassennamenwert ohne Berücksichtigung der Groß-/Kleinschreibung bereitstellen, der sich von den vom System bereitgestellten Klassen in Devguid.h unterscheidet. Die Länge der Klassennamenzeichenfolge muss maximal 32 Zeichen lang sein. Der INF muss einen neu generierten GUID-Wert für den ClassGUID-Eintrag angeben. Weitere Informationen finden Sie auch im Abschnitt INF ClassInstall32.
Dieser Eintrag ist für ein INF irrelevant, das weder einen neuen Gerätetreiber unter einer vordefinierten Gerätesetupklasse noch eine neue Gerätesetupklasse installiert.
Hinweis
Dieser Eintrag ist für Gerätetreiber erforderlich, die über den Plug & Play-Manager (PnP) installiert werden.
ClassGuid={nnnnnnnnn-nnnn-nnnnn- nnnrn99999999999999999999999999999999999999999999999999999999999999999999999999999-
Gibt die GUID der Geräteeinrichtungsklasse an. Der GUID-Wert wird wie hier dargestellt formatiert, wobei jedes n eine Hexadezimalziffer ist.
Dieser GUID-Wert gibt die Gerätesetupklasse an, die Geräten zugewiesen werden soll, die aus dieser INF-Datei installiert werden. Dieser klassenspezifische GUID-Wert identifiziert auch den Geräteklasseninstaller für den Gerätetyp und den klassenspezifischen Eigenschaftenseitenanbieter( falls vorhanden).
Für eine neue Gerätesetupklasse muss der INF einen neu generierten ClassGUID-Wert angeben. Weitere Informationen zum Erstellen von GUIDs finden Sie unter Verwenden von GUIDs in Treibern. Weitere Informationen finden Sie unter Gerätesetupklassen.
Hinweis
Dieser Eintrag ist für Gerätetreiber erforderlich, die über den PnP-Manager installiert werden.
ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx}
Gibt die Erweiterungs-ID-GUID beim Erstellen einer Erweiterung INF an. Der GUID-Wert wird wie hier dargestellt formatiert, wobei jedes x eine Hexadezimalziffer ist.
Beim Erstellen der ersten Version einer Erweiterung INF muss das INF einen neu generierten ExtensionId-Wert angeben. Beim Aktualisieren einer vorhandenen Erweiterung INF muss die ExtensionId jedoch gleich bleiben, sodass mehrere verwandte Versionen der Erweiterung INF füreinander versioniert werden, anstatt als unabhängige Erweiterungs-INFs behandelt zu werden, die gleichzeitig auf demselben Gerät instance installiert werden können. Weitere Informationen zum Erstellen von Erweiterungs-INFs finden Sie unter Verwenden einer ERWEITERUNG INF-Datei.
Hinweis
Dieser Eintrag ist nur erforderlich, wenn eine Erweiterung inF erstellt wird, wie durch Angabe Class = Extension von und ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}identifiziert.
ClassVer=major.kleiner
Reserviert für die Systemnutzung, sofern dies nicht explizit von einer Geräteklasse wie Printer erforderlich ist. Siehe z. B. V4 Driver INF.
Provider=%INF-creator%
Gibt den Anbieter der INF-Datei an. In der Regel wird dies als %OrganizationName-Token% angegeben, das später im Abschnitt Strings der INF-Datei erweitert wird. Die maximale Länge eines Anbieternamens in Zeichen ist LINE_LEN.
Beispielsweise geben mit dem System bereitgestellte INF-Dateien in der Regel den INF-Creator als %Msft% an und definieren %Msft% = "Microsoft" in ihren Zeichenfolgenabschnitten .
Hinweis
Dieser Eintrag ist für Gerätetreiber erforderlich, die über den PnP-Manager installiert werden.
CatalogFile=filename.cat
Gibt einen Katalog an (.cat)-Datei, die auf dem Verteilungsmedium eines Treiberpakets enthalten sein soll.
Wenn ein Treiberpaket zur digitalen Signatur an Microsoft übermittelt wird, stellt WHQL eine Katalogdatei für das Treiberpaket bereit, nachdem WHQL digitale Signaturen getestet und dem Paket zugewiesen hat. Weitere Informationen zum Testen und Signieren von IHV- oder OEM-Treiberpaketen finden Sie unter WHQL Release Signature. Katalogdateien werden nicht im Abschnitt SourceDisksFiles oder der CopyFiles-Direktive des INF aufgeführt. Windows geht davon aus, dass sich die Katalogdatei am selben Speicherort wie die INF-Datei befindet.
Vom System bereitgestellte INF-Dateien verfügen nie über CatalogFile= -Einträge, da das Betriebssystem die Signatur für eine solche INF mit allen vom System bereitgestellten xxx.cat-Dateien überprüft.
CatalogFile.nt=unique-filename.cat |
CatalogFile.ntx86=unique-filename.cat |
CatalogFile.ntia64=unique-filename.cat |
CatalogFile.ntamd64=unique-filename.cat
CatalogFile.ntarm=unique-filename.cat
CatalogFile.ntarm64=unique-filename.cat
Gibt einen anderen inF-writer-bestimmten, eindeutigen Dateinamen mit dem an. cat-Erweiterung einer Katalogdatei. Wenn diese optionalen Einträge weggelassen werden, wird eine angegebene CatalogFile=filename.cat zum Überprüfen von WDM-Geräte-/Treiberinstallationen verwendet.
Wenn eine artgezierte CatalogFile vorhanden ist.Der xxx-Eintrag= ist im Abschnitt Version eines INF zusammen mit einem nicht ergänzten CatalogFile= -Eintrag vorhanden. Es wird davon ausgegangen, dass der nicht ergänzte Eintrag einen filename.cat für die Validierung von Geräteinstallationen, Treiberinstallationen oder beides auf den Plattformen identifiziert, für die kein ergänzter Eintrag angegeben ist.
Jede plattformübergreifende Gerätetreiber-INF-Datei mit CatalogFile= und CatalogFile.xxx-Einträge= müssen einen eindeutigen IHV/OEM-ermittelten Namen für jede solche .cat-Datei angeben.
Weitere Informationen zur Verwendung der systemdefinierten Erweiterungen .nt, .ntx86, .ntia64, .ntamd64, .ntarm und .ntarm64 finden Sie unter Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme.
Hinweis
Da dieselbe CAT-Datei auf allen unterstützten Plattformen verwendet werden kann, ist die Verwendung dieses Eintrags nicht erforderlich oder empfohlen. Sie müssen diesen Eintrag jedoch verwenden, wenn Sie plattformspezifische CAT-Dateien für Ihr Treiberpaket erstellen möchten.
DriverVer=mm/tt/yyyy,w.x.y.z
Dieser Eintrag gibt Versionsinformationen für Treiber an, die von dieser INF-Datei installiert werden. Ab Windows 2000 ist dieser Eintrag erforderlich.
Informationen zum Angeben dieses Eintrags finden Sie unter INF DriverVer-Direktive.
PnpLockDown=0|1
Gibt an, ob Plug & Play (PnP) verhindert, dass Anwendungen die Dateien, die in der INF-Datei eines Treiberpakets angegeben sind, direkt ändern. Wenn die PnpLockDown-Direktive auf 1 festgelegt ist, verhindert PnP, dass Anwendungen die Dateien, die von INF CopyFiles-Direktiven kopiert werden, direkt ändern. Andernfalls kann eine Anwendung mit Administratorrechten diese Dateien direkt ändern, wenn die Direktive nicht in einer INF-Datei enthalten ist oder der Wert der Direktive auf Null festgelegt ist. Treiberdateien, die auf diese Weise geschützt sind, werden als von Drittanbietern geschützte Treiberdateien bezeichnet.
Um die Integrität einer PnP-Treiberinstallation sicherzustellen, sollten Anwendungen Treiberdateien, die von der INF-Datei des Treiberpakets kopiert werden, nicht direkt ändern. Anwendungen sollten nur die von Windows bereitgestellten Geräteinstallationsmechanismen verwenden, um PnP-Treiber zu aktualisieren.
Ab Windows Vista sollte ein Treiberpaket PnpLockDown auf 1 festlegen, um zu verhindern, dass eine Anwendung Treiberdateien direkt ändert. Einige vorhandene Anwendungen, die Treiberpakete deinstallieren, löschen treiberdateien jedoch direkt. Um die Kompatibilität mit diesen Anwendungen zu gewährleisten, sollte die PnpLockDown-Direktive für ein solches Treiberpaket auf Null festgelegt werden.
Hinweis
PnP unter Windows Vista und höheren Versionen von Windows erfordert zwar nicht, dass eine INF-Datei eine PnpLockDown-Direktive enthält, um einen Treiber zu installieren, PnP in einer zukünftigen Version von Windows erfordert jedoch möglicherweise, dass INF-Dateien für PnP-Treiberpakete die PnpLockDown-Direktive enthalten.
DriverPackageDisplayName=%driver-package-description%
Veraltet. Wurde zuvor von Treiberinstallationsframeworks (DIFx) verwendet. Informationen zur Deaktivierung von DIFx finden Sie unter DIFx-Richtlinien.
DriverPackageType=PackageType
Veraltet. Wurde zuvor von Treiberinstallationsframeworks (DIFx) verwendet. Informationen zur Deaktivierung von DIFx finden Sie unter DIFx-Richtlinien.
Hinweise
Wenn ein Treiberpaket WHQL-Tests (Microsoft Windows Hardware Quality Lab) besteht, gibt WHQL cat-Katalogdateien an die IHV oder den OEM zurück. Jede CAT-Datei enthält eine digital verschlüsselte Signatur für das Treiberpaket. Der IHV oder OEM muss diese CAT-Dateien im Abschnitt INF-Version auflisten und die Dateien auf den Verteilungsmedien am gleichen Speicherort wie die INF-Datei bereitstellen. Die CAT-Dateien müssen unkomprimiert sein.
Hinweis
Wenn ein INF-Versionsabschnitt nicht mindestens einen CatalogFile - oder CatalogFile.ntxxx-Eintrag enthält, wird der Treiber als nicht signiert behandelt, und die in der DriverVer-Direktive aufgeführten Datumsangaben werden von Windows nicht angezeigt.
Weitere Informationen finden Sie unter Treibersignatur.
Beispiele
Das folgende Beispiel zeigt einen Versionsabschnitt , der typisch für ein einfaches Treiberpaket INF ist, gefolgt von den erforderlichen Abschnitten SourceDisksNames und SourceDisksFiles , die durch die in diesem Beispielabschnitt angegebenen Einträge impliziert werden:
[Version]
Signature="$Windows NT$"
Class=SCSIAdapter
ClassGUID={4D36E97B-E325-11CE-BFC1-08002BE10318}
Provider=%INF_Provider%
CatalogFile=example.cat
DriverVer=01/29/2010,1.2.3.4
PnpLockdown=1
[SourceDisksNames]
;
; diskid = description[, [tagfile] [, <unused>, subdir]]
;
1 = %Disk_Description%,,,\WinNT
[SourceDisksFiles.x86]
;
; filename_on_source = diskID[, [subdir][, size]]
;
exampleDriver.sys = 1,\x86
; ...
[Strings]
INF_Provider="Contoso"
Disk_Description = "Contoso Drivers Disk"
; ...
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für