Sekcja INF DDInstall.HW

DDInstall. Sekcje HW są zwykle używane do instalowania urządzeń wielofunkcyjnych, instalowania sterowników filtrów PnP i konfigurowania dowolnych informacji specyficznych dla użytkownika, ale niezależnych od sterownika w rejestrze, niezależnie od tego, czy z jawnymi dyrektywami AddReg , czy też z wpisami Include and Needs .

[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] ...] 

Wpisy

Nie wszystkie prawidłowe wpisy są obsługiwane w uniwersalnym inf. Poniżej wymieniono dyrektywy, które są prawidłowe w uniwersalnym inf i które nie są.

Obsługiwane w uniwersalnym inf

AddReg=add-registry-section[,add-registry-section]...
Odwołuje się do co najmniej jednej sekcji dodatku zdefiniowanej przez składnik zapisywania INF w innym miejscu w pliku INF dla urządzeń objętych tą instalacją DDInstall. Sekcja HW . Sekcja add-registry-zazwyczaj instaluje filtry i/lub przechowuje informacje o poszczególnych urządzeniach w rejestrze. Specyfikacja HKR w takiej sekcji add-registry-określaklucz sprzętowy urządzenia, podklucz rejestru specyficzny dla urządzenia, który zawiera informacje o urządzeniu. Klucz sprzętu jest również nazywany kluczem urządzenia. Aby uzyskać więcej informacji, zobacz Drzewa rejestru i klucze dla urządzeń i sterowników. Pakiet sterowników może dodawać ustawienia za pośrednictwem inf przy użyciu specyfikacji HKR w sekcji add-registry-referenced by a DDInstall.HW sekcji.

Aby uzyskać więcej informacji, zobacz INF AddReg Directive (Dyrektywa INF AddReg).

Include=nazwa pliku. inf[,nazwa_pliku2.inf]...
Określa co najmniej jeden dodatkowy plik INF dostarczany przez system, który zawiera sekcje wymagane do zainstalowania tego urządzenia. Jeśli ten wpis jest określony, zazwyczaj jest to wpis Wymaga .

Needs=inf-section-name[,inf-section-name]...
Określa nazwane sekcje, które należy przetworzyć podczas instalacji tego urządzenia. Zazwyczaj taka nazwana sekcja to DDInstall. Sekcja HW w pliku INF dostarczonym przez system, który znajduje się w wpisie Dołączanie . Jednak może to być dowolna sekcja, do jakiej odwołuje się taka DDInstall. Sekcja HW dołączonego inf.

Nieobsługiwane w uniwersalnym inf

DelReg=del-registry-section[,del-registry-section]...
Odwołuje się do co najmniej jednej sekcji usuwania rejestru zdefiniowanejprzez moduł zapisywania INF w innym miejscu w pliku INF dla sterowników urządzeń objętych tą sekcją DDInstall . Taka sekcja delete-registry usuwa nieaktualne informacje o rejestrze dla wcześniej zainstalowanego urządzenia/sterownika z komputera docelowego. Specyfikacja HKR w takiej sekcji usuwania rejestru wyznacza ten sam podklucz co w przypadku funkcji AddReg.

Ta dyrektywa jest rzadko używana, z wyjątkiem pliku INF, który uaktualnia poprzednią instalację tych samych urządzeń/modeli wymienionych w sekcji dla poszczególnych producentów dla modeli , która zdefiniowała nazwę tej sekcji DDInstall . Aby uzyskać więcej informacji, zobacz INF DelReg, dyrektywa.

BitReg=bit-registry-section[,bit-registry-section] ...
Jest prawidłowy w tej sekcji, ale prawie nigdy nie był używany. Specyfikacja HKR w odwołanej sekcji rejestru bitów wyznacza ten sam podklucz co w przypadku funkcji AddReg. Aby uzyskać więcej informacji, zobacz InF BitReg Directive (Dyrektywa INF BitReg).

Remarks

Rozszerzenia bez uwzględniania wielkości liter w nazwie install-section-name wyświetlanej w instrukcji składni formalnej można wstawić do takiej instalacji DDInstall. Nazwa sekcji HW w plikach INF międzyplatformowych. Aby uzyskać więcej informacji na temat używania zdefiniowanych przez system rozszerzeń nt, ntx86, ntia64, ntamd64, ntarm i ntarm64 , zobacz Tworzenie plików INF dla wielu platform i systemów operacyjnych.

Wszelkie DDInstall. Sekcja HW musi mieć jedną z następujących opcji:

• Dyrektywa AddReg .
• Wpis Dołączanie , który określa inny plik INF. W tym przypadku DDInstall. Sekcja HW musi również zawierać odpowiedni wpis Wymaga , który określa sekcję w innym pliku INF. Ta sekcja służy do konfigurowania niezbędnych informacji rejestru.

Każda dyrektywa w DDInstall. Sekcja HW może odwoływać się do więcej niż jednej sekcji zdefiniowanej przez składnik zapisywania INF. Jednak każda dodatkowa nazwana sekcja musi być oddzielona od następnej przecinkiem (,).

Każda taka nazwa sekcji musi być unikatowa w pliku INF i musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz Ogólne reguły składni dla plików INF.

Aby uzyskać więcej informacji na temat sposobu instalowania urządzeń wielofunkcyjnych, zobacz Obsługa urządzeń wielofunkcyjnych.

Examples

W tym przykładzie pokazano, jak pakiet sterowników może używać narzędzia DDInstall. Sekcje HW i DDInstall. Sekcje usług w celu dodania zarówno sterownika funkcji, jak i sterownika górnego filtru PnP.

[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

Informacje dodatkowe

DodajReg

BitReg

DDInstall

DDInstall.Services

DelReg