ABSCHNITT "INF DDInstall.HW"
DDInstall. HW-Abschnitte werden in der Regel zum Installieren von Multifunktionsgeräten, zum Installieren von PnP-Filtertreibern und zum Einrichten beliebiger gerätespezifischer, aber treiberunabhängiger Informationen in der Registrierung verwendet, sei es mit expliziten AddReg-Anweisungen oder mit include - und Needs-Einträgen .
[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-section] ...]
Einträge
Nicht alle gültigen Einträge werden in einem universellen INF unterstützt. Im Folgenden wird aufgelistet, welche Direktiven in einem universellen INF gültig sind und welche nicht.
Unterstützt in einem universellen INF
AddReg=add-registry-section[,add-registry-section]...
Verweist auf einen oder mehrere inF-Writer-definierte Add-Registry-Abschnitte an anderer Stelle in der INF-Datei für die Geräte, die von diesem DDInstall abgedeckt werden. HW-Abschnitt . Im Abschnitt add-registry-werden in der Regel Filter installiert und/oder Informationen pro Gerät in der Registrierung gespeichert. Eine HKR-Spezifikation in einem solchen Add-Registry-Abschnitt gibt den Hardwareschlüssel des Geräts an, einen gerätespezifischen Registrierungsunterschlüssel, der Informationen zum Gerät enthält. Ein Hardwareschlüssel wird auch als Geräteschlüssel bezeichnet. Weitere Informationen finden Sie unter Registrierungsstrukturen und Schlüssel für Geräte und Treiber. Ein Treiberpaket kann Einstellungen über einen INF mithilfe einer HKR-Spezifikation in einem Add-Registry-Abschnitt hinzufügen, auf den durch einen DDInstall.HW-Abschnitt verwiesen wird.
Weitere Informationen finden Sie unter INF AddReg-Direktive.
Include=filename. inf[,filename2.inf]...
Gibt eine oder mehrere zusätzliche vom System bereitgestellte INF-Dateien an, die Abschnitte enthalten, die zum Installieren dieses Geräts erforderlich sind. Wenn dieser Eintrag angegeben ist, ist dies in der Regel der Eintrag Needs .
Needs=inf-section-name[,inf-section-name]...
Gibt die benannten Abschnitte an, die während der Installation dieses Geräts verarbeitet werden müssen. In der Regel ist ein solcher benannter Abschnitt ein DDInstall. HW-Abschnitt in einer systemseitig bereitgestellten INF-Datei, die in einem Include-Eintrag aufgeführt ist. Es kann jedoch ein beliebiger Abschnitt sein, auf den in einem solchen DDInstall verwiesen wird. HW-Abschnitt des enthaltenen INF.
In einem universellen INF nicht unterstützt
DelReg=del-registry-section[,del-registry-section]...
Verweist auf einen oder mehrere inF-writer-definierte delete-registry-sectionsan anderer Stelle in der INF-Datei für die Treiber der Geräte, die von diesem DDInstall-Abschnitt abgedeckt werden. Ein solcher Abschnitt zum Löschen der Registrierung entfernt veraltete Registrierungsinformationen für ein zuvor installiertes Gerät/Treiber vom Zielcomputer. Eine HKR-Spezifikation in einem solchen Delete-Registry-Abschnitt bestimmt den gleichen Unterschlüssel wie für AddReg.
Diese Direktive wird selten verwendet, außer in einer INF-Datei, die eine vorherige Installation der gleichen Geräte/Modelle aktualisiert, die im Abschnitt pro Hersteller pro Modell aufgeführt sind, in dem der Name dieses DDInstall-Abschnitts definiert wurde. Weitere Informationen finden Sie unter INF DelReg-Direktive.
BitReg=bit-registry-section[,bit-registry-section] ...
Ist in diesem Abschnitt gültig, wird aber fast nie verwendet. Eine HKR-Spezifikation in einem Bitregistrierungsabschnitt, auf den verwiesen wird, legt denselben Unterschlüssel wie für AddReg fest. Weitere Informationen finden Sie unter INF BitReg-Direktive.
Hinweise
Die Erweiterungen, bei der die Groß-/Kleinschreibung für den installationsabschnittsnamen nicht beachtet wird, die in der formalen Syntax-Anweisung angezeigt werden, können in ein solches DDInstall-Objekt eingefügt werden. HW-Abschnittsname in plattformübergreifenden INF-Dateien. 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.
Beliebiger DDInstall. Der HW-Abschnitt muss über einen der folgenden Elemente verfügen:
- Eine AddReg-Direktive .
- Ein Include-Eintrag , der eine andere INF-Datei angibt. In diesem Fall die DDInstall. Der HW-Abschnitt muss auch einen entsprechenden Needs-Eintrag enthalten, der einen Abschnitt in der anderen INF-Datei angibt. In diesem Abschnitt werden die erforderlichen Registrierungsinformationen eingerichtet.
Jede Direktive in einem DDInstall. Der HW-Abschnitt kann auf mehr als einen inF-writer-definierten Abschnitt verweisen. Jeder zusätzliche benannte Abschnitt muss jedoch vom nächsten durch ein Komma (,) getrennt werden.
Jeder solcher Abschnittsname muss innerhalb der INF-Datei eindeutig sein und den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.
Weitere Informationen zum Installieren von Multifunktionsgeräten finden Sie unter Unterstützen von Multifunktionsgeräten.
Beispiele
In diesem Beispiel wird gezeigt, wie ein Treiberpaket DDInstall verwenden kann. HW-Abschnitte und DDInstall. Dienstabschnitte zum Hinzufügen eines Funktionstreibers und eines PnP-Oberen Filtertreibers.
[Example_DDInstall]
CopyFiles=example_copyfiles
[Example_DDInstall.HW]
AddReg=filter_addreg
[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value
[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection
[function_ServiceInstallSection]
DisplayName = %function_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleFunctionDriver.sys
[filter_ServiceInstallSection]
DisplayName = %filter_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleUpperFilter.sys