Abschnitt "INF DestinationDirs"
Ein DestinationDirs-Abschnitt gibt das Zielzielverzeichnis bzw. die Zielverzeichnisse für alle Kopier-, Lösch- und/oder Umbenennungsvorgänge für Dateien an, auf die an anderer Stelle in der INF-Datei durch Namen verwiesen wird.
[DestinationDirs]
[DefaultDestDir=dirid[,subdir]]
[file-list-section=dirid[,subdir]]...
Einträge
DefaultDestDir=dirid[,subdir]
Gibt das Standardzielverzeichnis für alle Kopier-, Lösch- und/oder Umbenennungsvorgänge für Dateien an, die nicht explizit in einem Dateiliste-Abschnitt aufgeführt sind, auf den hier andere Einträge verweisen. Um sicherzustellen, dass Dateivorgänge immer im richtigen Verzeichnis stattfinden, sollte eine INF-Datei, die die Einträge Include und Needs enthält, kein Standardzielverzeichnis angeben. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
file-list-section=dirid[,subdir]] ...
Gibt den inF-writer-ermittelten Namen eines Abschnitts an, auf den eine CopyFiles-, RenFiles- oder DelFiles-Direktive an anderer Stelle in der INF-Datei verweist. Ein solcher Eintrag ist optional, wenn dieser Abschnitt über einen DefaultDestDir-Eintrag verfügt und alle in diesem INF angegebenen Kopierdateivorgänge das gleiche Ziel haben. Alle Dateilistenabschnitte , auf die eine RenFiles - oder DelFiles-Direktive an anderer Stelle im INF verweist, müssen hier aufgeführt werden.
dirid
Gibt den Verzeichnisbezeichner des Zielverzeichnisses für Vorgänge für Dateien an, auf die anhand des Namens verwiesen wird, möglicherweise innerhalb eines benannten datei-list-abschnitts des INF. Listen häufig verwendeter Dirids finden Sie unter Verwenden von Dirids. In Windows 10 Version 1709 und höheren Versionen von Windows wird empfohlen, DIRID 13 zu verwenden. Weitere Informationen finden Sie unter Ausführen aus dem Treiberspeicher .
Subdir
Gibt das Unterverzeichnis (und den restlichen Pfad, falls vorhanden, unter dem durch dirid identifizierten Verzeichnis) an, um das Ziel der Dateivorgänge im angegebenen datei-list-abschnitt zu sein.
Hinweise
Der Abschnitt DestinationDirs ist in jeder INF-Datei erforderlich, die eine INF CopyFiles-Direktive verwendet oder auf einen Dateilistenabschnitt verweist, unabhängig davon, ob es sich um eine CopyFiles-, DelFiles- oder RenFiles-Direktive handelt.
Wenn Abc.inf Abschnitte aus einer anderen INF-Datei enthält, Def.inf, und beide INF-Dateien einen DefaultDestDir-Eintrag für Copy-File-, Rename-File- oder Delete-File-Vorgänge enthalten, ignoriert Windows das Standardzielverzeichnis, das in Def.inf angegeben ist, und führt alle entsprechenden Dateivorgänge im Standardzielverzeichnis aus, das in Abc.inf angegeben ist.
Um sicherzustellen, dass Dateivorgänge immer in den richtigen Verzeichnissen stattfinden, sollte eine INF-Datei, die Include - und Needs-Einträge enthält, keinen DefaultDestDir-Eintrag in einem DestinationDirs-Abschnitt enthalten. Stattdessen sollte eine solche INF-Datei explizit auf alle Dateiliste-Abschnittsnamen verweisen, die durch die CopyFiles-, RenFiles- und DelFiles-Direktiven im Abschnitt DestinationDirs angegeben werden.
Wenn eine INF-Datei keine Include - und Needs-Einträge enthält, kann der INF-Eintrag DefaultDestDir verwenden, um ein Standardziel für Kopier-, Umbenennens- und Löschvorgänge anzugeben, die an anderer Stelle in der INF-Datei angezeigt werden:
- CopyFiles-Anweisungen, die die Notation für direkte Kopie (@Dateiname) verwenden, müssen im Abschnitt DestinationDirs des INF, in dem der Direct Copy-Eintrag angezeigt wird, über einen DefaultDestDir-Eintrag verfügen.
- CopyFiles-, RenFiles- oder DelFiles-Abschnitte , auf die nicht direkt im Abschnitt DestinationDirs verwiesen wird, müssen einen DefaultDestDir-Eintrag im Abschnitt DestinationDirs des INF aufweisen, in dem die Dateiabschnitte kopieren, umbenennen und löschen angezeigt werden.
Beispiele
In diesem Beispiel wird das Standardzielverzeichnis für alle Vorgänge copy-file, delete-file und rename-file festgelegt. Ein solcher einfacher DestinationDirs-Abschnitt ist für INF-Dateien für neue Peripheriegeräte üblich, da ein solcher INF in der Regel einfach einen Satz von Quelldateien in ein einzelnes Verzeichnis auf dem Zielcomputer kopiert.
[DestinationDirs]
DefaultDestDir = 13
Dieses Beispiel zeigt ein Fragment des Abschnitts DestinationDirs des INF für einen Anzeige-/Videotreiber.
[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