Sekcja InF DestinationDirs

Sekcja DestinationDirs określa docelowy katalog docelowy lub katalogi dla wszystkich operacji kopiowania, usuwania i/lub zmiany nazwy plików, do których odwołuje się nazwa w innym miejscu w pliku INF.

[DestinationDirs]

[DefaultDestDir=dirid[,subdir]] 
[file-list-section=dirid[,subdir]]... 

Wpisy

DefaultDestDir=dirid[,subdir]
Określa domyślny katalog docelowy dla wszystkich operacji kopiowania, usuwania i/lub zmiany nazwy plików, które nie są jawnie wymienione w sekcji file-list-referenced przez inne wpisy tutaj. Aby upewnić się, że operacje na plikach są zawsze wykonywane we właściwym katalogu, plik INF zawierający wpisy Dołączanie i Potrzeby nie powinien określać domyślnego katalogu docelowego. Aby uzyskać więcej informacji zobacz następujące sekcji uwag.

file-list-section=dirid[,subdir]] ...
Określa nazwę składnika zapisywania INF sekcji, do których odwołuje się dyrektywa CopyFiles, RenFiles lub DelFiles w innym miejscu w pliku INF. Taki wpis jest opcjonalny, jeśli ta sekcja ma wpis DefaultDestDir , a wszystkie operacje kopiowania plików określone w tym INF mają to samo miejsce docelowe. Jednak każda sekcja list-plików , do którego odwołuje się dyrektywa RenFiles lub DelFiles w innym miejscu innej struktury INF, musi być wymieniona tutaj.

dirid
Określa identyfikator katalogu docelowego dla operacji na plikach, do których odwołuje się nazwa, prawdopodobnie w nazwanej sekcji file-list-sekcji INF. Aby uzyskać listę często używanych dirids, zobacz Using Dirids (Używanie dirids). W Windows 10 w wersji 1709 i nowszych wersjach systemu Windows zaleca się użycie diRID 13. Aby uzyskać więcej informacji, zobacz run from Driver Store (Uruchamianie z magazynu sterowników ).

subdir
Określa podkatalog (i pozostałą część ścieżki, jeśli istnieje, w katalogu zidentyfikowanym przez dirid) jako miejsce docelowe operacji na plikach w danej sekcji file-list-section.

Remarks

Sekcja DestinationDirs jest wymagana w dowolnym pliku INF, który używa dyrektywy INF CopyFiles lub odwołuje się do sekcji file-list-section, niezależnie od tego, czy z dyrektywą CopyFiles, DelFiles lub RenFiles .

Jeśli plik Abc.inf zawiera sekcje z innego pliku INF, Def.inf i oba pliki INF zawierają wpis DefaultDestDir dla operacji copy-file, rename-file lub delete-file, Windows ignoruje domyślny katalog docelowy określony w pliku Def.inf i wykonuje wszystkie odpowiednie operacje na plikach w domyślnym katalogu docelowym określonym w abc.inf.

Aby upewnić się, że operacje na plikach są zawsze wykonywane we poprawnych katalogach, plik INF zawierający wpisy Include and Needs nie powinien zawierać wpisu DefaultDestDir w sekcji DestinationDirs . Zamiast tego taki plik INF powinien jawnie odwoływać się do wszystkich nazw sekcji listy plików, które są określone przez dyrektywy CopyFiles, RenFiles i DelFiles w sekcji DestinationDirs.

Jeśli plik INF nie zawiera wpisów Uwzględnij i Wymaga , inf może użyć wpisu DefaultDestDir , aby określić domyślną lokalizację docelową dla operacji kopiowania, zmiany nazwy i usuwania plików, które pojawiają się gdzie indziej w pliku INF:

• Dyrektywy CopyFiles korzystające z notacji kopiowania bezpośredniego (@nazwa pliku) muszą mieć wpis DefaultDestDir w sekcji DestinationDirs inf, w którym pojawia się wpis kopiowania bezpośredniego.
• Sekcje CopyFiles, RenFiles lub DelFiles, które nie są bezpośrednio przywołyane w sekcji DestinationDirs, muszą mieć wpis DefaultDestDir w sekcji DestinationDirs inf, w którym są wyświetlane sekcje kopiowania, zmiany nazwy i usuwania plików.

Examples

W tym przykładzie ustawia domyślny katalog docelowy dla wszystkich operacji copy-file, delete-file i rename-file. Taka prosta sekcja DestinationDirs jest często spotykana w przypadku plików INF dla nowych urządzeń peryferyjnych, ponieważ taka funkcja INF zwykle kopiuje zestaw plików źródłowych do pojedynczego katalogu na komputerze docelowym.

[DestinationDirs]
DefaultDestDir = 13

W tym przykładzie pokazano fragment sekcji DestinationDirs inF dla sterownika wyświetlania/wideo.

[DestinationDirs]
DefaultDestDir     = 13

; ... 

; list of per-Manufacturer, per-Models, per-DDInstall-section, and
; CopyFiles-referenced xxx.Miniport/xxx.Display sections omitted here
; along with several other miniport/display paired drivers
; ...
vga.Miniport     = 13
vga.Display      = 13
xga.Miniport     = 13
xga.Display      = 13

Informacje dodatkowe

CopyFiles

DDInstall

DelFiles

RenFiles

SourceDisksFiles

SourceDisksNames

Używanie dirids