Seção DestinationDirs do INF

  • Artigo

Uma seção DestinationDirs especifica o diretório ou diretórios de destino para todas as operações de cópia, exclusão e/ou renomeação em arquivos referenciados por nome em outro lugar no arquivo INF.

[DestinationDirs]

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

Entradas

DefaultDestDir=dirid[,subdir]
Especifica o diretório de destino padrão para todas as operações de cópia, exclusão e/ou renomeação em arquivos que não estão explicitamente listados em uma seção de lista de arquivos referenciada por outras entradas aqui. Para garantir que as operações de arquivo sempre ocorram no diretório correto, um arquivo INF que inclui entradas Include e Needs não deve especificar um diretório de destino padrão. Para obter mais informações, consulte a seção Comentários a seguir.

file-list-section=dirid[,subdir]] ...
Especifica o nome determinado pelo gravador INF de uma seção referenciada por uma diretiva CopyFiles, RenFiles ou DelFiles em outro lugar no arquivo INF. Essa entrada será opcional se esta seção tiver uma entrada DefaultDestDir e todas as operações de arquivo de cópia especificadas neste INF tiverem o mesmo destino. No entanto, qualquer seção de lista de arquivos referenciada por uma diretiva RenFiles ou DelFiles em outro lugar no INF deve ser listada aqui.

dirid
Especifica o identificador de diretório do diretório de destino para operações em arquivos referenciados por nome, possivelmente dentro de uma seção de lista de arquivos nomeada do INF. Para obter listas de dirids comumente usados, consulte Usando Dirids. No Windows 10 versão 1709 e versões posteriores do Windows, é recomendável que o DIRID 13 seja usado. Confira executar no Repositório de Driver para obter mais informações.

Subdir
Especifica o subdiretório (e o restante de seu caminho, se houver, no diretório identificado por dirid) para ser o destino das operações de arquivo na seção de lista de arquivos fornecida.

Comentários

A seção DestinationDirs é necessária em qualquer arquivo INF que use uma diretiva COPYFiles INF ou que faça referência a uma seção de lista de arquivos, seja com uma diretiva CopyFiles, DelFiles ou RenFiles .

Se Abc.inf incluir seções de outro arquivo INF, Def.inf e ambos os arquivos INF incluirem uma entrada DefaultDestDir para operações de arquivo de cópia, renomeação ou arquivo de exclusão, o Windows ignorará o diretório de destino padrão especificado em Def.inf e executará todas as operações de arquivo correspondentes no diretório de destino padrão especificado em Abc.inf.

Para garantir que as operações de arquivo sempre ocorram nos diretórios corretos, um arquivo INF que inclui entradas Include e Needs não deve incluir uma entrada DefaultDestDir em uma seção DestinationDirs . Em vez disso, esse arquivo INF deve referenciar explicitamente todos os nomes de seção de lista de arquivos especificados pelas diretivas CopyFiles, RenFiles e DelFiles na seção DestinationDirs .

Se um arquivo INF não incluir entradas Include e Needs , o INF poderá usar a entrada DefaultDestDir para especificar um destino padrão para operações de arquivo de cópia, renomeação e exclusão que aparecem em outro lugar no arquivo INF:

  • As diretivas CopyFiles que usam a notação de cópia direta (@filename) devem ter uma entrada DefaultDestDir na seção DestinationDirs do INF em que a entrada de cópia direta é exibida.
  • As seções CopyFiles, RenFiles ou DelFiles que não são referenciadas diretamente na seção DestinationDirs devem ter uma entrada DefaultDestDir na seção DestinationDirs do INF em que as seções copiar, renomear e excluir arquivo aparecem.

Exemplos

Este exemplo define o diretório de destino padrão para todas as operações copy-file, delete-file e rename-file. Uma seção DestinationDirs tão simples é comum a arquivos INF para novos dispositivos periféricos, pois esse INF geralmente apenas copia um conjunto de arquivos de origem em um único diretório no computador de destino.

[DestinationDirs]
DefaultDestDir = 13

Este exemplo mostra um fragmento da seção DestinationDirs do INF para um driver de vídeo/exibição.

[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

Confira também

CopyFiles

DDInstall

DelFiles

RenFiles

SourceDisksFiles

SourceDisksNames

Usando Dirids