Sección Inf DestinationDirs
Una sección DestinationDirs especifica el directorio o directorios de destino de destino para todas las operaciones de copia, eliminación o cambio de nombre en los archivos a los que se hace referencia por nombre en otra parte del archivo INF.
[DestinationDirs]
[DefaultDestDir=dirid[,subdir]]
[file-list-section=dirid[,subdir]]...
Entradas
DefaultDestDir=dirid[,subdir]
Especifica el directorio de destino predeterminado para todas las operaciones de copia, eliminación o cambio de nombre en los archivos que no aparecen explícitamente en una sección de lista de archivos a la que hacen referencia otras entradas aquí. Para asegurarse de que las operaciones de archivo siempre se producen en el directorio correcto, un archivo INF que incluya entradas Include y Needs no debe especificar un directorio de destino predeterminado. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
file-list-section=dirid[,subdir]] ...
Especifica el nombre determinado por INF-writer de una sección a la que hace referencia una directiva CopyFiles, RenFiles o DelFiles en otra parte del archivo INF. Esta entrada es opcional si esta sección tiene una entrada DefaultDestDir y todas las operaciones de archivo de copia especificadas en este INF tienen el mismo destino de destino. Sin embargo, cualquier sección de lista de archivos a la que hace referencia una directiva RenFiles o DelFiles en otra parte del INF debe aparecer aquí.
dirid
Especifica el identificador de directorio del directorio de destino para las operaciones en archivos a los que se hace referencia por nombre, posiblemente dentro de una sección denominada file-list-section del INF. Para obtener listas de dirids usados habitualmente, consulte Uso de dirids. En Windows 10 versión 1709 y versiones posteriores de Windows, se recomienda usar DIRID 13. Consulte Ejecución desde el Almacén de controladores para obtener más información.
subdir
Especifica el subdirectorio (y el resto de su ruta de acceso, si existe, en el directorio identificado por dirid) para que sea el destino de las operaciones de archivo en la sección file-list-section especificada.
Comentarios
La sección DestinationDirs es necesaria en cualquier archivo INF que use una directiva CopyFiles inf o que haga referencia a una sección file-list-section, ya sea con una directiva CopyFiles, DelFiles o RenFiles .
Si Abc.inf incluye secciones de otro archivo INF, Def.inf y ambos archivos INF incluyen una entrada DefaultDestDir para las operaciones copy-file, rename-file o delete-file, Windows omite el directorio de destino predeterminado especificado en Def.inf y realiza todas las operaciones de archivo correspondientes en el directorio de destino predeterminado especificado en Abc.inf.
Para asegurarse de que las operaciones de archivo siempre se producen en los directorios correctos, un archivo INF que incluya entradas Include y Needs no debe incluir una entrada DefaultDestDir en una sección DestinationDirs . En su lugar, dicho archivo INF debe hacer referencia explícitamente a todos los nombres de sección file-list-section especificados por las directivas CopyFiles, RenFiles y DelFiles en la sección DestinationDirs .
Si un archivo INF no incluye entradas Include y Needs , inf puede usar la entrada DefaultDestDir para especificar un destino predeterminado para las operaciones de copia, cambio de nombre y eliminación de archivos que aparecen en otra parte del archivo INF:
- Las directivas CopyFiles que usan la notación de copia directa (@filename) deben tener una entrada DefaultDestDir en la sección DestinationDirs de la inf en la que aparece la entrada de copia directa.
- Las secciones CopyFiles, RenFiles o DelFiles a las que no se hace referencia directamente en la sección DestinationDirs deben tener una entrada DefaultDestDir en la sección DestinationDirs del INF en la que aparecen las secciones copiar, cambiar nombre y eliminar archivo.
Ejemplos
En este ejemplo se establece el directorio de destino predeterminado para todas las operaciones copy-file, delete-file y rename-file. Esta sencilla sección DestinationDirs es común a los archivos INF para nuevos dispositivos periféricos, ya que este tipo de INF normalmente solo copia un conjunto de archivos de origen en un único directorio del equipo de destino.
[DestinationDirs]
DefaultDestDir = 13
En este ejemplo se muestra un fragmento de la sección DestinationDirs del INF para un controlador de pantalla y vídeo.
[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