Sekcja Domyślna instalacja w programie INF

Dostęp do sekcji DefaultInstall pliku INF jest uzyskiwany, jeśli użytkownik wybierze element menu "Zainstaluj" po wybraniu i przytrzymaniu (lub kliknięciu prawym przyciskiem myszy) nazwy pliku INF. W Windows 10 wersji 1903 i nowszych wersji Windows interfejs INF z funkcją DefaultInstall może być używany w wielu interfejsach API pakietów sterowników, jeśli spełnia wymagania sterownika pierwotnego.

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

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

CopyFiles=@nazwa | pliku-list-sekcji[,file-list-section] ...
Ta opcjonalna dyrektywa określa jeden nazwany plik do skopiowania z nośnika źródłowego do miejsca docelowego lub odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, które określają pliki, które mają być przesyłane z nośnika źródłowego do miejsca docelowego.

Wpis DefaultDestDir w sekcji DestinationDirs INF określa miejsce docelowe skopiowania dowolnego pojedynczego pliku. Sekcje SourceDisksNames i SourceDisksFiles lub dodatkowa funkcja INF określona w wpisie LayoutFile tej sekcji Wersji INF podaj lokalizację na nośniku dystrybucji plików sterowników.

Aby uzyskać więcej informacji, zobacz dyrektywa INF CopyFiles.

CopyINF=nazwa_pliku1.inf[,nazwa_pliku2.inf]...
(Windows XP i nowsze wersje Windows). Ta dyrektywa powoduje skopiowanie określonych plików INF do systemu docelowego.

Aby uzyskać więcej informacji, zobacz dyrektywa 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.

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

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 systemowe pliki INF dla sterowników urządzeń, które zależą od obsługi przesyłania strumieniowego jądra systemu, określają 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 to DDInstall (lub DDInstall).sekcja xxx) w jednym z plików INF wymienionych we wpisie Dołączanie. Jednak może to być dowolna sekcja, do którego odwołuje się taka DDInstall lub DDInstall.sekcja xxx dołączonego inf.

Na przykład pliki INF dla sterowników urządzeń, które mają poprzedni wpis Include , określ ten wpis w następujący sposób:

Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation

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 INF DelFiles, dyrektywa.

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 INF RenFiles, dyrektywa.

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ń.

Aby uzyskać więcej informacji, zobacz INF DelReg, dyrektywa.

BitReg=bit-registry-section[,bit-registry-section]...
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 . Aby uzyskać więcej informacji, zobacz INF AddReg Directive (Dyrektywa INF AddReg).

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

ProfileItems=profile-items-section[,profile-items-section]...
Ta dyrektywa odwołuje się do co najmniej jednej sekcji zdefiniowanej przez moduł zapisywania INF, które opisują elementy do dodania lub usunięcia z menu Start.

Aby uzyskać więcej informacji, zobacz dyrektywa 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 określonego źródłowego pliku INI o tej samej nazwie można określić w sekcji update-ini.

Aby uzyskać więcej informacji, zobacz INF UpdateInis, dyrektywa.

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 INF UpdateIniFields, dyrektywa.

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 ini2Reg dyrektywy INF.

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 INF RegisterDlls Directive (Dyrektywa INF RegisterDlls).

UnregisterDlls=unregister-dll-section[,unregister-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ą samodzielnego wyrejestrowania (samodzielnego usuwania).

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

Remarks

Sekcje DefaultInstall nie mogą być używane w przypadku instalacji urządzeń. Użyj sekcji DefaultInstall tylko w przypadku instalacji sterowników filtrów klas, filtrów systemu plików i usług sterowników jądra, które nie są skojarzone z węzłem urządzenia (devnode).

W przypadku używania polecenia DefaultInstall w wersji Windows 10 w wersji 1903 i nowszych Windows zaleca się, aby plik INF spełniał wymagania sterownika pierwotnego.

Aby zainstalować sekcję DefaultInstall z poziomu aplikacji instalacyjnej urządzenia, użyj następującego wywołania polecenia InstallHinfSection:

InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0); 

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.

Examples

W poniższym przykładzie przedstawiono typową sekcję DefaultInstall :

[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries

Informacje dodatkowe

DDInstall

DriverVer

LogConfig