ABSCHNITT "INF-Version"
Der Abschnitt "Version" wird standardmäßig zuerst in INF-Dateien angezeigt. Jede INF-Datei muss diesen Abschnitt aufweisen.
[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]
Entries
Signature="signature-name"
Muss $Windows NT$ oder $Chicago$ sein. Dies gibt die Betriebssysteme an, für die diese INF gültig ist. Diese Signaturwerte haben die folgenden Bedeutungen.
| Signaturwert | Bedeutung |
|---|---|
| $Windows NT$ | Alle Windows-Betriebssysteme |
| $Chicago$ | Alle Windows-Betriebssysteme |
Die eingeschlossenen Dollarzeichen ($) sind erforderlich, aber bei diesen Zeichenfolgen wird die Groß-/Kleinschreibung beachtet. Wenn der Signaturname keines dieser Zeichenfolgenwerte ist, wird die Datei nicht als gültiges 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 jemand, der eine INF-Datei liest, die Betriebssysteme bestimmen kann, für die er vorgesehen ist.
Einige Klasseninstallationsprogramme legen zusätzliche Anforderungen für die Angabe des Signaturwerts fest. Solche Anforderungen werden, sofern vorhanden, in gerätetypspezifischen Abschnitten dieses Windows Driver Kit (WDK) erläutert.
Ein INF muss betriebssystemspezifische Installationsinformationen bereitstellen, indem systemdefinierte Erweiterungen an die DDInstall-Abschnitte angefügt werden, unabhängig davon, ob der Signaturname $Windows NT$ oder $Chicago$ist. (Siehe Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme für eine Erläuterung dieser Erweiterungen.)
Class=class-name
Für jeden Standardtyp von Geräten gibt dies den Namen der Geräteeinrichtungsklasse 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 seinen 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, die INF-Suche zu optimieren.
Wenn ein INF dem System eine neue Setupklasse von Geräten hinzufügt, sollte er einen eindeutigen, ohne Groß-/Kleinschreibung unterschiedenen Klassennamenwert bereitstellen, der sich von einer der vom System bereitgestellten Klassen in Devguid.h unterscheidet. Die Länge der Klassennamenzeichenfolge muss maximal 32 Zeichen lang sein. Die INF muss einen neu generierten GUID-Wert für den ClassGUID-Eintrag angeben. Siehe auch INF ClassInstall32 Section.
Dieser Eintrag ist für einen INF irrelevant, der weder einen neuen Gerätetreiber unter einer vordefinierten Gerätesetupklasse noch eine neue Geräteeinrichtungsklasse installiert.
Hinweis
Dieser Eintrag ist für Gerätetreiber erforderlich, die über den Plug & Play-Manager (PnP) installiert werden.
ClassGuid={nnnnn-n-nn-n n-n}
Gibt die GUID der Geräteeinrichtungsklasse an. Der GUID-Wert wird wie hier gezeigt formatiert, wobei jede n eine hexadezimale Ziffer ist.
Dieser GUID-Wert gibt die Geräteeinrichtungsklasse an, die Geräten zugewiesen werden soll, die aus dieser INF-Datei installiert sind. Dieser klassenspezifische GUID-Wert identifiziert auch das Geräteklasseninstallationsprogramm für den Typ des Geräte- und klassenspezifischen Eigenschaftenseitenanbieters, falls vorhanden.
Bei einer neuen Geräteeinrichtungsklasse muss die INF einen neu generierten ClassGUID-Wert angeben. Weitere Informationen zum Erstellen von GUIDs finden Sie unter Verwenden von GUIDs in Treibern. Siehe auch Gerätesetupklassen.
Hinweis
Dieser Eintrag ist für Gerätetreiber erforderlich, die über den PnP-Manager installiert werden.
ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx}
Gibt die GUID der Erweiterungs-ID beim Erstellen einer Erweiterung INF an. Der GUID-Wert wird wie hier gezeigt formatiert, wobei jedes x eine hexadezimale Ziffer ist.
Beim Erstellen der ursprünglichen Version einer Erweiterung INF muss der INF-Wert einen neu generierten ExtensionId-Wert angeben. Beim Aktualisieren einer vorhandenen Erweiterungs-INF muss die ExtensionId jedoch gleich bleiben, sodass mehrere verwandte Versionen der Erweiterung INF gegeneinander versioniert werden, anstatt als unabhängige Erweiterungs-INFs behandelt zu werden, die gleichzeitig auf derselben Geräteinstanz installiert werden können. Weitere Informationen zum Erstellen von Erweiterungs-INFs finden Sie unter Verwenden einer INF-Erweiterungsdatei.
Hinweis
Dieser Eintrag ist nur erforderlich, wenn eine Erweiterung INF erstellt wird, wie durch Angeben und Angeben Class = Extension angegeben ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}.
ClassVer=major.kleiner
Reserviert für die Systemverwendung, es sei denn, dies ist explizit von einer Geräteklasse wie Printer erforderlich. Siehe z. B . V4 Driver INF.
Provider=%INF-Creator%
Identifiziert den Anbieter der INF-Datei. 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 INF-Dateien, die mit dem System bereitgestellt werden, 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 den Verteilungsmedien 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 "CopyFiles"-Direktive der INF aufgeführt. Windows geht davon aus, dass sich die Katalogdatei an demselben 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 auf alle 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-determined, eindeutigen Dateinamen mit dem .cat extension, of a catalog file. Wenn diese optionalen Einträge weggelassen werden, wird eine angegebene CatalogFile=filename.cat für die Überprüfung von WDM-Geräte-/Treiberinstallationen verwendet.
If any decorated CatalogFile.xxx-Eintrag ist im Abschnitt "Version" eines INF zusammen mit einem nicht ausgestalteten CatalogFile=-Eintrag vorhanden, wobei davon ausgegangen wird, dass ein filename.cat für die Überprüfung von Geräteinstallationen, Treiberinstallationen oder beide Plattformen identifiziert wird, für die kein versehener Eintrag angegeben wird.=
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 .nt-, .ntx86-, .ntia64-, .ntamd64-, .ntarm- und .ntarm64-Erweiterungen finden Sie unter Creating INF Files for Multiple Platforms and Operating Systems.
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/dd/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 die INF-Datei eines Treiberpakets angibt, 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. Wenn die Direktive nicht in einer INF-Datei enthalten ist oder der Wert der Direktive auf Null festgelegt ist, kann eine Anwendung mit Administratorrechten diese Dateien direkt ändern. Treiberdateien, die auf diese Weise geschützt sind, werden als drittanbietergeschützte Treiberdateien bezeichnet.
Um die Integrität einer PnP-Treiberinstallation sicherzustellen, sollten Anwendungen keine Treiberdateien direkt ändern, die von der INF-Datei des Treiberpakets kopiert werden. 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 jedoch direkt Treiberdateien. Um die Kompatibilität mit diesen Anwendungen aufrechtzuerhalten, sollte die PnpLockDown-Direktive für dieses Treiberpaket auf Null festgelegt werden.
Hinweis
Obwohl PnP unter Windows Vista und höheren Versionen von Windows nicht erfordert, dass eine INF-Datei eine PnpLockDown-Direktive enthält, um einen Treiber zu installieren, erfordert PnP in einer zukünftigen Version von Windows möglicherweise, dass INF-Dateien für PnP-Treiberpakete die PnpLockDown-Direktive enthalten.
DriverPackageDisplayName=%driver-package-description%
Veraltet. Wurde zuvor von Driver Install Frameworks (DIFx) verwendet. Informationen zum Veraltet von DIFx finden Sie in den DIFx-Richtlinien.
DriverPackageType= PackageType
Veraltet. Wurde zuvor von Driver Install Frameworks (DIFx) verwendet. Informationen zum Veraltet von DIFx finden Sie in den DIFx-Richtlinien.
Hinweise
Wenn ein Treiberpaket die Tests von Microsoft Windows Hardware Quality Lab (WHQL) bestanden hat, gibt WHQL DIE CAT-Katalogdateien an den IHV oder OEM zurück. Jede CAT-Datei enthält eine digital verschlüsselte Signatur für das Treiberpaket. Die IHV- oder OEM-Datei muss diese CAT-Dateien im ABSCHNITT "INF-Version" auflisten und die Dateien auf den Verteilungsmedien an demselben Speicherort wie die INF-Datei bereitstellen. Die CAT-Dateien müssen nicht komprimiert werden.
Hinweis
Wenn ein INF-Versionsabschnitt mindestens einen CatalogFile- oder CatalogFile.ntxxx-Eintrag nicht enthält, wird der Treiber als nicht signiert behandelt, und die in der DriverVer-Direktive aufgeführten Daten 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 von den in diesem Beispielversionsabschnitt angegebenen Einträgen 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"
; ...