Abschnitt "INF DefaultInstall"
Hinweis
Wenn Sie ein universelles Treiberpaket erstellen, ist dieser Abschnitt nur gültig, wenn er über eine Architekturdekoration verfügt, z. B [DefaultInstall.NTAMD64]. .
Hinweis
Die Verwendung der Abschnitte DefaultInstall und Manufacturer in Ihrem INF führt zu Fehlern der universellen INF-Überprüfung und kann zu inkonsistenten Installationsverhalten führen. Weitere Informationen finden Sie unter Verwenden einer universellen INF-Datei.
Auf den Abschnitt DefaultInstall einer INF-Datei wird zugegriffen, wenn ein Benutzer das Menüelement "Installieren" auswählt, nachdem er den INF-Dateinamen ausgewählt und gedrückt hat (oder mit der rechten Maustaste darauf klickt). Unter Windows 10 Version 1903 und höher von Windows kann ein INF mit DefaultInstall in vielen Treiberpaket-APIs verwendet werden, wenn er die Anforderungen eines primitiven Treibers 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. Im Folgenden wird aufgelistet, welche Anweisungen 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 Anweisung 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 vom Quellmedium 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ätzliches INF, das im Abschnitt LayoutFile des Abschnitts Version dieses INF angegeben ist, geben den Speicherort auf dem Verteilungsmedium der Treiberdateien an.
Weitere Informationen finden Sie unter INF CopyFiles-Direktive.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP und höhere Versionen von Windows.) Diese Anweisung bewirkt, dass angegebene INF-Dateien in das Zielsystem kopiert werden.
Weitere Informationen finden Sie unter INF CopyINF-Direktive.
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, zum Schreiben in die Registrierung angegeben werden 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 wird, ist dies in der Regel ein Eintrag Erforderlich .
Beispielsweise geben die System-INF-Dateien für Gerätetreiber, die von der Kernel-Streaming-Unterstü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 innerhalb der 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) in 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-Objekt 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 für das zu löschende Ziel enthalten.
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 aufgeführt werden, die am 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 vom 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-Direktive.
UpdateInis=update-ini-section[,update-ini-section]...
Diese selten verwendete Direktive verweist auf einen oder mehrere INF-Writer-definierte Abschnitte und gibt eine INI-Quelldatei an, aus der ein bestimmter Abschnitt oder eine bestimmte Zeile in einem solchen Abschnitt während der Installation in eine ZIEL-INI-Datei mit demselben Namen gelesen werden soll. Optional können Zeilen-für-Zeile-Änderungen an einer vorhandenen INI-Datei auf dem Ziel aus einer angegebenen QUELL-INI-Datei 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 in den 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 dem Quellmedium bereitgestellt wird, in die Registrierung verschoben werden sollen.
Weitere Informationen finden Sie unter INF Ini2Reg-Direktive.
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-Direktive.
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 (Selbstentfernung) erfordern.
Weitere Informationen finden Sie unter INF Aufheben der RegistrierungDlls-Direktive.
Hinweise
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 nicht einem Geräteknoten (devnode) zugeordnet sind.
Wenn Sie DefaultInstall unter Windows 10 Version 1903 und höher von Windows verwenden, wird empfohlen, dass die INF-Datei die Anforderungen eines primitiven Treibers erfüllt.
Hinweis
Die INF-Datei eines Treiberpakets mit dem Abschnitt Hersteller darf keinen INF DefaultInstall-Abschnitt enthalten, wenn das Treiberpaket digital signiert werden soll. Weitere Informationen zum Signieren von Treiberpaketen finden Sie unter Treibersignatur.
Hinweis
Im Gegensatz zu einem DDInstall-Abschnitt kann ein DefaultInstall-Abschnitt keine DriverVer- oder LogConfig-Direktive enthalten.
Um einen DefaultInstall-Abschnitt aus einer Geräteinstallationsanwendung zu installieren, verwenden Sie den folgenden Aufruf von InstallHinfSection:
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
Weitere Informationen zur Verwendung der vom System definierten Erweiterungen .nt, .ntx86, .ntia64, .ntamd64, .ntarm und .ntarm64 finden Sie unter Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme.
Beispiele
Das folgende Beispiel zeigt einen typischen DefaultInstall-Abschnitt :
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries