ABSCHNITT "INF DestinationDirs"

Ein Abschnitt "DestinationDirs " gibt das Zielverzeichnis oder 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 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 Dateilistenabschnitt aufgeführt sind, auf den von anderen Einträgen hier verwiesen wird. Um sicherzustellen, dass Dateivorgänge immer im richtigen Verzeichnis auftreten, sollte eine INF-Datei, die Include - und Needs-Einträge enthält, kein Standardzielverzeichnis angeben. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

File-list-section=dirid[,subdir]] ...
Gibt den INF-Writer-bestimmten Namen eines Abschnitts an, auf den von einer CopyFiles-, RenFiles- oder DelFiles-Direktive an anderer Stelle in der INF-Datei verwiesen wird. Ein solcher Eintrag ist optional, wenn dieser Abschnitt über einen DefaultDestDir-Eintrag verfügt und alle in diesem INF angegebenen Kopierdateivorgänge dasselbe Ziel haben. Allerdings müssen alle Dateilistenabschnitte , auf die von einer RenFiles - oder DelFiles-Direktive an anderer Stelle in der INF verwiesen wird, 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 Dateilistenabschnitts des INF. Listen häufig verwendeter Dirids finden Sie unter Verwenden von Dirids. Für Windows 10 Version 1709 und neuere Versionen von Windows wird empfohlen, DIRID 13 zu verwenden. Weitere Informationen finden Sie unter "Ausführen aus dem Treiberspeicher ".

Unterdir
Gibt das Unterverzeichnis (und den Rest des Pfads, sofern vorhanden, unter dem durch dirid identifizierten Verzeichnis) als Ziel der Dateivorgänge im angegebenen Dateilistenabschnitt an.

Bemerkungen

Der Abschnitt "DestinationDirs" ist in jeder INF-Datei erforderlich, die eine INF CopyFiles-Direktive verwendet oder auf einen Dateilistenabschnitt verweist, ob mit einer CopyFiles-, DelFiles- oder RenFiles-Direktive.

Wenn Abc.inf Abschnitte aus einer anderen INF-Datei, Def.inf und beide INF-Dateien einen DefaultDestDir-Eintrag für Kopier-, Umbenennen- oder Löschdateivorgänge enthält, ignoriert Windows das in Def.inf angegebene Standardzielverzeichnis 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 auftreten, 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 Dateilistenabschnittsnamen verweisen, die durch 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 den DefaultDestDir-Eintrag verwenden, um ein Standardziel für Kopier-, Umbenennungs- und Löschvorgänge anzugeben, die an anderer Stelle in der INF-Datei angezeigt werden:

  • CopyFiles-Direktiven , die die Direktkopienotation (@filename) verwenden, müssen einen DefaultDestDir-Eintrag im Abschnitt "DestinationDirs " des INF aufweisen, in dem der Direktkopie-Eintrag angezeigt wird.
  • CopyFiles-, RenFiles- oder DelFiles-Abschnitte, auf die nicht direkt im Abschnitt DestinationDirs verwiesen wird, müssen über einen DefaultDestDir-Eintrag im Abschnitt "DestinationDirs" des INF verfügen, in dem die Abschnitte "Kopieren", "Umbenennen" und "Löschen" angezeigt werden.

Examples

In diesem Beispiel wird das Standardzielverzeichnis für alle Kopier-, Lösch- und Umbenennungsdateivorgänge festgelegt. Ein solcher einfacher DestinationDirs-Abschnitt ist üblich für INF-Dateien für neue Peripheriegeräte, da eine solche INF in der Regel nur eine Reihe 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

Siehe auch

CopyFiles

DDInstall

DelFiles

RenFiles

SourceDisksFiles

SourceDisksNames

Verwenden von Dirids