INF DDInstall.HW-Abschnitt

DDInstall. HW-Abschnitte werden in der Regel zum Installieren von Multifunktionsgeräten, zum Installieren von PnP-Filtertreibern und zum Einrichten von gerätespezifischen, aber treiberunabhängigen Informationen in der Registrierung verwendet, ob mit expliziten AddReg-Direktiven 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. 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

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 Add-Registry-Abschnitt 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 über das 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 eine 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[,Dateiname2.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 ein Bedarfseintrag .

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 vom System bereitgestellten INF-Datei, die in einem Include-Eintrag aufgeführt ist. Es kann jedoch ein beliebiger Abschnitt sein, auf den innerhalb eines 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-defined delete-registry-sectionsan anderer Stelle in der INF-Datei für die Treiber der Geräte, die in diesem DDInstall-Abschnitt behandelt werden. Ein solcher Abschnitt "Delete-Registry" entfernt veraltete Registrierungsinformationen für ein zuvor installiertes Gerät/Treiber vom Zielcomputer. Eine HKR-Spezifikation in einem solchen Delete-Registry-Abschnitt bezeichnet denselben Unterschlüssel wie für AddReg.

Diese Richtlinie wird nur 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, der den Namen dieses DDInstall-Abschnitts definiert hat. Weitere Informationen finden Sie unter INF DelReg-Direktive.

BitReg=bit-registry-section[,bit-registry-section] ...
Ist in diesem Abschnitt gültig, aber fast nie verwendet. Eine HKR-Spezifikation in einem referenzierten Bitregistrierungsabschnitt bezeichnet denselben Unterschlüssel wie für AddReg. Weitere Informationen finden Sie unter INF BitReg-Direktive.

Bemerkungen

Die in der formalen Syntax-Anweisung gezeigten Installationsabschnittserweiterungen können in einen solchen DDInstall eingefügt werden. HW-Abschnittsname in plattformübergreifenden INF-Dateien. 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.

Beliebiges 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 DDInstall. Der HW-Abschnitt muss auch einen entsprechenden Bedarfseintrag enthalten, der einen Abschnitt in der anderen INF-Datei angibt. Dieser Abschnitt wird verwendet, um die erforderlichen Registrierungsinformationen einzurichten.

Jede Direktive in einem DDInstall. Der HW-Abschnitt kann auf mehr als einen INF-writer-defined-Abschnitt verweisen. Jeder zusätzliche benannte Abschnitt muss jedoch durch ein Komma (,) vom nächsten getrennt werden.

Jeder solcher Abschnittsname muss innerhalb der INF-Datei eindeutig sein und muss 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.

Examples

In diesem Beispiel wird gezeigt, wie ein Treiberpaket das DDInstall verwenden kann. HW-Abschnitte und DDInstall. Dienste abschnitte, um sowohl einen Funktionstreiber als auch einen PnP-Oberen Filtertreiber hinzuzufügen.

[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

Siehe auch

AddReg

BitReg

DDInstall

DDInstall.Services

DelReg