Sekcja INF DDInstall
Każda sekcja DDInstall zawiera opcjonalną dyrektywę DriverVer i co najmniej jedną dyrektywę odwołującą się do dodatkowych nazwanych sekcji w pliku INF, pokazanych tutaj z najczęściej określonymi dyrektywami INF, CopyFiles i AddReg, wymienione jako pierwsze.
Sekcje, do których odwołuje się te dyrektywy, zawierają instrukcje dotyczące instalowania plików sterowników i zapisywania wszelkich informacji specyficznych dla urządzenia i/lub informacji specyficznych dla sterownika w rejestrze.
[install-section-name] |
[install-section-name.nt] |
[install-section-name.ntx86] |
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[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]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[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]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]
Wpisy
Nie wszystkie prawidłowe wpisy są obsługiwane w universal INF. Poniżej wymieniono dyrektywy, które są prawidłowe w uniwersalnym inf i które nie są.
Obsługiwane w uniwersalnym inf
DriverVer=mm/dd/rrrr[,x.y.v.z]
Ten opcjonalny wpis określa informacje o wersji pakietu sterowników .
Aby uzyskać informacje na temat sposobu określania tego wpisu, zobacz dyrektywy INF DriverVer.
CopyFiles=@ nazwa pliku | file-list-section[,file-list-section] ...
Ta dyrektywa określa jeden nazwany plik, który ma zostać skopiowany z nośnika źródłowego do miejsca docelowego lub odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, w których są określone pliki istotne dla urządzenia na nośniku źródłowym do transferu do miejsca docelowego. Dyrektywa CopyFiles jest opcjonalna, ale jest obecna w większości sekcji DDInstall.
Wpis DefaultDestDir w sekcji DestinationDirs INF określa miejsce docelowe kopiowania dowolnego pojedynczego pliku. Sekcje SourceDisksNames i SourceDisksFiles lub dodatkowe INF określone w wpisie LayoutFile sekcji wersji tego inF podaj lokalizację na nośniku dystrybucji plików sterowników.
Aby uzyskać więcej informacji, zobacz dyrektywy INF CopyFiles.
CopyINF= nazwa pliku1.inf[, nazwa pliku2.inf]...
(Windows XP i nowsze) Ta dyrektywa powoduje skopiowanie określonych plików INF do systemu docelowego.
Aby uzyskać więcej informacji, zobacz dyrektywy INF CopyINF.
AddReg=add-registry-section[,add-registry-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, w których nowe podklucze, prawdopodobnie z wpisami wartości początkowej, są określone do zapisania w rejestrze lub w którym są modyfikowane wpisy wartości istniejących kluczy.
Specyfikacja HKR w takiej sekcji add-registry wyznacza "klucz oprogramowania" ścieżki rejestru instalowanego urządzenia.
Aby uzyskać więcej informacji, zobacz dyrektywy INF AddReg.
AddProperty=add-property-section[,add-property-section]...
(Windows Vista i nowsze) Odwołuje się do co najmniej jednej sekcji pliku INF, które modyfikują właściwości urządzenia ustawione dla wystąpienia urządzenia. Należy użyć dyrektywy INF AddProperty tylko w celu ustawienia właściwości wystąpienia urządzenia, która jest nowa dla systemu Windows Vista lub nowszych wersji systemów operacyjnych Windows.
W przypadku właściwości wystąpienia urządzenia, które zostały wprowadzone wcześniej w systemie Windows Server 2003, Windows XP lub Windows 2000 i które mają odpowiednie wartości wpisu rejestru, należy nadal używać dyrektyw INF AddReg, aby ustawić właściwości wystąpienia urządzenia. Te wytyczne dotyczą właściwości zdefiniowanych przez system i właściwości niestandardowych. Aby uzyskać więcej informacji na temat używania dyrektywy AddProperty, zobacz Using the INF AddProperty Directive and the INF DelProperty Directive.
Include= nazwa pliku1.inf[, nazwa pliku2.inf]...
Ten opcjonalny wpis określa jeden lub więcej dodatkowych plików INF dostarczanych przez system, które zawierają sekcje wymagane do zainstalowania tego urządzenia i/lub sterownika. Jeśli ten wpis jest określony, zazwyczaj jest to wpis Wymaga.
Na przykład pliki INF sterowników urządzeń, które zależą od obsługi przesyłania strumieniowego jądra systemu, mogą określać ten wpis w następujący sposób:
Include= ks.inf, kscaptur.inf, ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Ten opcjonalny wpis określa sekcje w plikach INF dostarczanych przez system, które muszą być przetwarzane podczas instalacji tego urządzenia. Zazwyczaj taka nazwana sekcja jest sekcją DDInstall (lub DDInstall.xxx) w jednym z plików INF wymienionych w Dołącz wpis. Jednak może to być dowolna sekcja, do jakiej odwołuje się DDInstall lub DDInstall.xxx sekcji dołączonej INF.
Na przykład pliki INF dla sterowników urządzeń, które mają poprzedni Uwzględnij wpis może określać ten wpis w następujący sposób:
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurescore
Ostrzeżenie
Dyrektywa
(Windows Vista i nowsze) Ta dyrektywa zawiera dodatkowe kryterium klasyfikacji sterowników opartych na funkcjach, które obsługuje sterownik. Na przykład wyniki funkcji można zdefiniować dla klasy konfiguracji urządzenia , która rozróżnia między sterownikami na podstawie kryteriów specyficznych dla klasy.
Aby uzyskać więcej informacji na temat sposobu klasyfikacji sterowników, zobacz How Windows Ranks Drivers (Windows Vista and Later).
Aby uzyskać więcej informacji na temat tej dyrektywy, zobacz dyrektywy INF FeatureScore.
Nuta
Mimo że sekcja DDInstall może zawierać wiele wpisów FeatureScore, tylko pierwszy wpis jest przetwarzany dla tej sekcji.
ExcludeID=ciąg-identyfikacji urządzenia[,ciąg-identyfikacji urządzenia]...
Ostrzeżenie
Dyrektywa
(Windows XP i nowsze) Ta dyrektywa określa co najmniej jeden ciąg identyfikacji urządzenia (identyfikatory sprzętu lub identyfikatory zgodne z ). Sekcja DDInstall nie instaluje urządzeń, które mają identyfikatory urządzeń zgodne z dowolnymi identyfikatorami sprzętu lub zgodnymi identyfikatorami.
ponownego rozruchu
Ta dyrektywa wskazuje, że obiekt wywołujący powinien zostać poproszony o ponowne uruchomienie systemu po zakończeniu instalacji.
Aby uzyskać więcej informacji, zobacz dyrektywy INF reboot.
Nieobsługiwane w uniwersalnym inf
Delfiles=file-list-section[,file-list-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF zawierającej listę plików w obiekcie docelowym, które mają zostać usunięte.
Aby uzyskać więcej informacji, zobacz dyrektywy INF DelFiles.
Renfiles=file-list-section[,file-list-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF zawierającej listę plików, które mają zostać zmienione w miejscu docelowym, zanim pliki źródłowe odpowiednie dla urządzenia zostaną skopiowane na komputer docelowy.
Aby uzyskać więcej informacji, zobacz dyrektywy INF RenFiles.
DelReg=del-registry-section[,del-registry-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, w których klucze i/lub wpisy wartości są określone do usunięcia z rejestru podczas instalacji urządzeń.
Zazwyczaj ta dyrektywa jest używana do obsługi uaktualnień, gdy inf musi wyczyścić stare wpisy rejestru z poprzedniej instalacji tego urządzenia.
Specyfikacja HKR w takiej sekcji rejestru usuwania wyznacza "klucz oprogramowania" ścieżki rejestru instalowanego urządzenia.
Aby uzyskać więcej informacji, zobacz dyrektywy INF DelReg.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista i nowsze) Odwołuje się do co najmniej jednej sekcji pliku INF, które usuwają właściwości urządzenia ustawione dla wystąpienia urządzenia. Należy użyć dyrektywy INF DelProperty tylko do usunięcia właściwości wystąpienia urządzenia, która jest nowa dla systemu Windows Vista lub nowszych wersji systemu Windows.
W przypadku właściwości wystąpienia urządzenia, które zostały wprowadzone wcześniej w systemie Windows Server 2003, Windows XP lub Windows 2000 i które mają odpowiednie wartości wpisu rejestru, należy nadal używać dyrektyw INF DelReg, aby usunąć właściwości wystąpienia urządzenia. Te wytyczne dotyczą właściwości zdefiniowanych przez system i właściwości niestandardowych. Aby uzyskać więcej informacji na temat używania dyrektywy DelProperty, zobacz Using the INF AddProperty Directive and the INF DelProperty Directive.
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, w których są modyfikowane istniejące wpisy wartości rejestru typu REG_BINARY.
Specyfikacja HKR w takiej sekcji rejestru bitowego wyznacza "klucz oprogramowania" ścieżki rejestru instalowanego urządzenia.
Aby uzyskać więcej informacji, zobacz dyrektywy BITReg inf.
LogConfig=log-config-section[,log-config-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF w module INF dla urządzenia wyliczanego przez użytkownika głównego lub dla ręcznie zainstalowanego urządzenia. W tych nazwanych sekcjach inf dla takiego "wykrytego" lub ręcznie zainstalowanego urządzenia określa co najmniej jedną logiczną konfigurację zasobów sprzętowych względnych magistrali, które urządzenie musi być operacyjne. InF dla takiego ręcznie zainstalowanego urządzenia, które nie jest konfigurowalne programowo, powinno również mieć DDInstall. Sekcja FactDef.
Dyrektywa LogConfig nigdy nie jest używana do instalowania urządzeń Plug and Play (PnP). Można jednak użyć sekcji INF DDInstall.LogConfigOverride, aby zapewnić konfigurację zastąpienia dla urządzeń PnP.
Ta dyrektywa nie ma znaczenia dla wszystkich sterowników i składników wyższego poziomu (urządzeń).
Aby uzyskać więcej informacji, zobacz dyrektywy INF LogConfig.
ProfileItems=profile-items-section[,profile-items-section-]...
(Microsoft Windows 2000 i nowsze wersje systemu Windows) Ta rzadko używana dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, które opisują elementy, które mają być dodawane lub usuwane z menu Start.
Aby uzyskać więcej informacji, zobacz dyrektywy INF ProfileItems.
UpdateInis=update-ini-section[,update-ini-section]...
Ta rzadko używana dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, określając źródłowy plik INI, z którego podczas instalacji należy odczytać konkretną sekcję lub wiersz w ramach takiej sekcji. Opcjonalnie modyfikacje wiersz po wierszu istniejącego pliku INI w miejscu docelowym z danego źródłowego pliku INI o tej samej nazwie można określić w sekcji update-ini.
Aby uzyskać więcej informacji, zobacz dyrektywy INF UpdateInis.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Ta rzadko używana dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, w których określono modyfikacje w wierszach pliku INI specyficznego dla urządzenia.
Aby uzyskać więcej informacji, zobacz dyrektywy INF UpdateIniFields.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Ta rzadko używana dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, w których do rejestru mają zostać przeniesione sekcje lub wiersze z pliku INI specyficznego dla urządzenia dostarczonego na nośniku źródłowym.
Aby uzyskać więcej informacji, zobacz dyrektywy INF Ini2Reg.
RegisterDlls=register-dll-section[,register-dll-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji INF używanej do określania plików, które są kontrolkami OLE i wymagają samodzielnej rejestracji.
Aby uzyskać więcej informacji, zobacz dyrektywy INF RegisterDlls.
UnregisterDlls=wyrejestrowywanie-dll-section[,wyrejestrowywanie-dll-sekcji]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji INF używanej do określania plików, które są kontrolkami OLE i wymagają samodzielnego wyrejestrowania (samodzielnego usuwania).
Aby uzyskać więcej informacji, zobacz INF UnregisterDlls Directive.
Uwagi
W dokumentacji zestawu Windows Driver Kit (WDK) termin DDInstall jest używany do odwoływania się do nazwa-sekcji-instalacji, z lub bez rozszerzeń platformy. W związku z tym "sekcja DDInstall" oznacza "sekcję nazwaną w inf, o formacie [nazwa-sekcji] lub [nazwa-sekcji-instalacji.ntxxx]". Podczas tworzenia nazw dla sekcji DDInstall należy dołączyć prefiks specyficzny dla urządzenia, taki jak [WDMPNPB003_Device] lub [GPR400. Install.NT].
Do każdej sekcji
Z wyjątkiem urządzeń, które nie mają skojarzonych plików do przesyłania z nośnika źródłowego, plik INF, który instaluje sterownik WDM na różnych platformach systemu operacyjnego, musi mieć co najmniej jedną z następujących sekcji DDInstall:
- Sekcja install-section-name.ntx86, która określa wpisy dotyczące instalacji urządzeń/sterowników specyficznych dla platform opartych na x86.
- Sekcja install-section-name.ntia64, która określa wpisy dla instalacji urządzeń/sterowników specyficznych dla platform opartych na itanium.
- Sekcja install-section-name.ntamd64, która określa wpisy dotyczące instalacji urządzeń/sterowników specyficznych dla platform opartych na x64.
- Sekcja install-section-name.ntarm, która określa wpisy dotyczące instalacji urządzeń/sterowników specyficznych dla platform opartych na usłudze Arm.
- Sekcja install-section-name.ntarm64 sekcja określająca wpisy dotyczące instalacji urządzeń/sterowników specyficznych dla platform opartych na architekturze Arm64.
- Sekcja install-section-name lub nazwa-sekcji-instalacji.nt sekcja, która określa wpisy instalacji urządzeń/sterowników, które nie są specyficzne dla określonej platformy sprzętowej.
Aby uzyskać więcej informacji na temat używania zdefiniowanego przez system .nt, .ntx86, .ntia64, .ntamd64, .ntarmi .ntarm64 rozszerzeń, zobacz Tworzenie plików INF dla wielu platform i systemów operacyjnych.
Począwszy od systemu Windows 2000, plik INF, który instaluje sterowniki, musi mieć sekcje DDInstall.Services, aby określić informacje o usłudze sterownika.
Każda dyrektywa w sekcji DDInstall może odwoływać się do więcej niż jednej nazwy sekcji. Jednak każda dodatkowa nazwana sekcja musi być oddzielona od następnej przecinkiem (,).
Każda 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.
Zakłada się, że każda dyrektywa AddReg określona w sekcji DDInstall odwołuje się do sekcji add-registry, która nie może służyć do przechowywania informacji o sterownikach górnych lub niższych filtrach, o urządzeniach wielofunkcyjnych lub o parametrach niezależnych od sterownika, ale specyficznych dla urządzenia. Jeśli urządzenie/sterownik INF musi przechowywać tego typu informacje w rejestrze, musi użyć dyrektywy AddReg w nieukodowanych i ozdobionych DDInstall. Sekcje HW, jeśli istnieją, aby odwołać się do innego składnika zapisywania INF zdefiniowanego add-registry-section.
W zależności od klasy konfiguracji urządzenia , która została określona w sekcji wersja INF, dodatkowe dyrektywy specyficzne dla klasy można określić w sekcji DDInstall. Aby uzyskać więcej informacji na temat dyrektyw specyficznych dla klasy, zobacz następujące tematy:
- tworzenie pliku INF dla urządzenia SideShow-Compatible z systemem Windows
- sekcja DDInstall w pliku INF sieci
- plików INF dla urządzeń obrazów nadal
- pliki INF dla urządzeń WIA
- wymagania dotyczące instalacji składników sieciowych
- określanie dyrektyw WDF w plikach INF
Przykłady
W tym przykładzie pokazano rozszerzenie sekcji
[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles
[Ser_CopyFiles]
sermouse.sys
[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys
[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles
[Inp_CopyFiles]
inport.sys
W poniższym przykładzie przedstawiono sekcję DDInstall pliku INF, który instaluje sterownik WDM dostarczony przez system dla urządzenia audio na różnych platformach systemu operacyjnego:
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
W poniższym przykładzie przedstawiono sekcje, do których odwołuje się poprzedni wpis
[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
DeviceRegistration
CopyFiles=KSProxy.Files,KSDriver.Files
[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;
Zobacz też
DDInstall. coinstallers
DDInstall. FactDef
DDInstall. HW
DDInstall. usług