ABSCHNITT "INF DefaultInstall"

Hinweis

Wenn Sie ein universelles Treiberpaket erstellen, ist dieser Abschnitt nur gültig, wenn er über eine Architekturdeko verfügt, z. B [DefaultInstall.NTAMD64]. .

Hinweis

Die Verwendung von DefaultInstall - und Manufacturer-Abschnitten in Ihrem INF führt zu Universellen INF-Überprüfungsfehlern und kann zu inkonsistenten Installationsverhalten führen. Siehe Verwenden einer universellen INF-Datei.

Auf den DefaultInstall-Abschnitt einer INF-Datei wird zugegriffen, wenn ein Benutzer das Menüelement "Installieren" auswählt, nachdem er den INF-Dateinamen ausgewählt und gedrückt (oder mit der rechten Maustaste darauf geklickt hat). In Windows 10 Version 1903 und höheren Versionen von Windows kann ein INF mit DefaultInstall in vielen Treiberpaket-APIs verwendet werden, wenn er die Anforderungen eines Grundtyptreibers erfüllt.

[DefaultInstall] | 
[DefaultInstall.nt] | 
[DefaultInstall.ntx86] | 
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
 
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...] ...

Einträge

Nicht alle gültigen Einträge werden in einem universellen INF unterstützt. In der folgenden Liste sind die Richtlinien aufgeführt, die in einem universellen INF gültig sind und welche nicht.

Unterstützt in einem universellen INF

CopyFiles=@filename | file-list-section[,file-list-section] ...
Diese optionale Direktive gibt entweder eine benannte Datei an, die vom Quellmedium auf das Ziel kopiert werden soll, oder verweist auf einen oder mehrere INF-writer-definierte Abschnitte, die dateien angeben, die von den Quellmedien an das Ziel übertragen werden sollen.

Der DefaultDestDir-Eintrag im Abschnitt "DestinationDirs " des INF gibt das Ziel für jede einzelne Datei an, die kopiert werden soll. Die Abschnitte "SourceDisksNames " und "SourceDisksFiles " oder ein zusätzlicher INF, der im LayoutFile-Eintrag des Abschnitts "Version " dieses INF angegeben ist, stellen den Speicherort auf den Verteilungsmedien der Treiberdateien bereit.

Weitere Informationen finden Sie unter INF CopyFiles-Direktive.

CopyINF=filename1.inf[,filename2.inf]...
(Windows XP und höhere Versionen von Windows.) Diese Direktive bewirkt, dass angegebene INF-Dateien in das Zielsystem kopiert werden.

Weitere Informationen finden Sie unter INF CopyINF-Richtlinie.

AddReg=add-registry-section[,add-registry-section]...
Diese Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen neue Unterschlüssel, möglicherweise mit Anfangswerteinträgen, in die Registrierung geschrieben werden sollen oder in denen die Werteinträge vorhandener Schlüssel geändert werden.

Weitere Informationen finden Sie unter INF AddReg-Direktive.

Include=filename1.inf[,filename2.inf]...
Dieser optionale Eintrag gibt eine oder mehrere zusätzliche vom System bereitgestellte INF-Dateien an, die Abschnitte enthalten, die zum Installieren dieses Geräts und/oder Treibers erforderlich sind. Wenn dieser Eintrag angegeben ist, ist dies in der Regel ein Bedarfseintrag .

Beispielsweise geben die SYSTEM-INF-Dateien für Gerätetreiber, die von der Kernelstreamingunterstützung des Systems abhängen, diesen Eintrag wie folgt an:

Include= ks.inf,kscaptur.inf,ksfilter.inf

Needs=inf-section-name[,inf-section-name]...
Dieser optionale Eintrag gibt Abschnitte in vom System bereitgestellten INF-Dateien an, die während der Installation dieses Geräts verarbeitet werden müssen. In der Regel ist ein solcher benannter Abschnitt ein DDInstall (oder DDInstall).xxx) Abschnitt innerhalb einer der INF-Dateien, die in einem Include-Eintrag aufgeführt sind. Es kann jedoch ein beliebiger Abschnitt sein, auf den in einem solchen DDInstall oder DDInstall verwiesen wird.xxx-Abschnitt des enthaltenen INF.

Beispielsweise geben die INF-Dateien für Gerätetreiber mit dem vorherigen Include-Eintrag diesen Eintrag wie folgt an:

Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation

In einem universellen INF nicht unterstützt

Delfiles=file-list-section[,file-list-section]...
Diese Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, die Dateien auf dem Zu löschenden Ziel auflisten.

Weitere Informationen finden Sie unter INF DelFiles-Direktive.

Renfiles=file-list-section[,file-list-section]...
Diese Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen Dateien aufgelistet werden, die auf dem Ziel umbenannt werden sollen, bevor geräterelevante Quelldateien auf den Zielcomputer kopiert werden.

Weitere Informationen finden Sie unter INF RenFiles-Direktive.

DelReg=del-registry-section[,del-registry-section]...
Diese Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen Schlüssel- und/oder Werteinträge angegeben werden, die während der Installation der Geräte aus der Registrierung entfernt werden sollen.

Weitere Informationen finden Sie unter INF DelReg-Direktive.

BitReg=bit-registry-section[,bit-registry-section]...
Diese Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen vorhandene Registrierungswerteinträge vom Typ REG_BINARY geändert werden. Weitere Informationen finden Sie unter INF AddReg-Direktive.

Weitere Informationen finden Sie unter INF BitReg-Direktive.

ProfileItems=profile-items-section[,profile-items-section]...
Diese Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen Elemente beschrieben werden, die dem Startmenü hinzugefügt oder daraus entfernt werden sollen.

Weitere Informationen finden Sie unter INF ProfileItems Directive.

UpdateInis=update-ini-section[,update-ini-section]...
Diese selten verwendete Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, wobei eine INI-Quelldatei angegeben wird, aus der ein bestimmter Abschnitt oder eine bestimmte Zeile innerhalb eines solchen Abschnitts während der Installation in eine ZIEL-INI-Datei mit demselben Namen gelesen werden soll. Optional können Zeilen-by-Line-Änderungen an einer vorhandenen INI-Datei am Ziel aus einer angegebenen INI-Quelldatei mit demselben Namen im Abschnitt "update-ini" angegeben werden.

Weitere Informationen finden Sie unter INF UpdateInis-Direktive.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Diese selten verwendete Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen Änderungen innerhalb der Zeilen einer gerätespezifischen INI-Datei angegeben werden.

Weitere Informationen finden Sie unter INF UpdateIniFields-Direktive.

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Diese selten verwendete Direktive verweist auf einen oder mehrere INF-writer-definierte Abschnitte, in denen Abschnitte oder Zeilen aus einer gerätespezifischen INI-Datei, die auf den Quellmedien bereitgestellt wird, in die Registrierung verschoben werden.

Weitere Informationen finden Sie unter INF Ini2Reg-Richtlinie.

RegisterDlls=register-dll-section[,register-dll-section]...
Diese Direktive verweist auf einen oder mehrere INF-Abschnitte, die verwendet werden, um Dateien anzugeben, die OLE-Steuerelemente sind und eine Selbstregistrierung erfordern.

Weitere Informationen finden Sie unter INF RegisterDlls-Richtlinie.

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Diese Direktive verweist auf einen oder mehrere INF-Abschnitte, die verwendet werden, um Dateien anzugeben, die OLE-Steuerelemente sind und die Selbstregistrierung erfordern (Self-Removal).

Weitere Informationen finden Sie unter INF UnregisterDlls-Richtlinie.

Bemerkungen

DefaultInstall-Abschnitte dürfen nicht für Geräteinstallationen verwendet werden. Verwenden Sie DefaultInstall-Abschnitte nur für die Installation von Klassenfiltertreibern, Dateisystemfiltern und Kerneltreiberdiensten, die keinem Geräteknoten (Devnode) zugeordnet sind.

Wenn Sie DefaultInstall auf Windows 10 Version 1903 und neueren Versionen von Windows verwenden, wird empfohlen, dass die INF-Datei die Anforderungen eines Grundtyptreibers erfüllt.

Hinweis

Die INF-Datei eines Treiberpakets mit einem Herstellerabschnitt darf keinen INF DefaultInstall-Abschnitt enthalten, wenn das Treiberpaket digital signiert werden soll. Weitere Informationen zum Signieren von Treiberpaketen finden Sie unter "Treibersignierung".

Hinweis

Im Gegensatz zu einem DDInstall-Abschnitt kann ein DefaultInstall-Abschnitt keine DriverVer - oder LogConfig-Direktiven enthalten.

Verwenden Sie zum Installieren eines DefaultInstall-Abschnitts aus einer Geräteinstallationsanwendung den folgenden Aufruf von InstallHinfSection:

InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0); 

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.

Examples

Das folgende Beispiel zeigt einen typischen DefaultInstall-Abschnitt :

[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries

Siehe auch

DDInstall

DriverVer

LogConfig