Diretiva INF DelFiles

Artigo
03/08/2023

Cuidado

Se você estiver criando um pacote universal ou do Driver do Windows, essa diretiva não será válida. Consulte Usando um arquivo INF universal e Introdução com drivers do Windows.

Uma diretiva DelFiles faz referência a uma seção definida pelo gravador INF em outro lugar no arquivo INF e faz com que essa lista de arquivos seja excluída no contexto de operações na seção na qual a diretiva DelFiles de referência é especificada.

[DDInstall] | 
[DDInstall.CoInstallers] | 
[ClassInstall32] | 
[ClassInstall32.ntx86] | 
[ClassInstall32.ntia64] | (Windows XP and later versions of Windows)
[ClassInstall32.ntamd64] | (Windows XP and later versions of Windows) 
[ClassInstall32.ntarm] | (Windows 8 and later versions of Windows) 
[ClassInstall32.ntarm64] (Windows 10 version 1709 and later versions of Windows) 
  
Delfiles=file-list-section[,file-list-section]...

Uma diretiva DelFiles pode ser especificada em qualquer uma das seções mostradas na instrução de sintaxe formal. Essa diretiva também pode ser especificada em qualquer uma das seguintes seções definidas pelo gravador INF:

Uma seção add-interface referenciada pela diretiva AddInterface em um DDInstall. Seção Interfaces .
Uma seção install-interface referenciada em uma seção InterfaceInstall32

Cada seção nomeada referenciada por uma diretiva DelFiles tem uma ou mais entradas do seguinte formulário:

[file-list-section]
 
destination-file-name[,,,flag]
...

Uma seção de lista de arquivos pode ter qualquer número de entradas, cada uma em uma linha separada.

Entradas

destination-file-name
Especifica o nome do arquivo a ser excluído do destino.

Não especifique um arquivo listado em uma diretiva CopyFiles . Se um arquivo estiver listado em uma seção referenciada por CopyFiles e uma seção referenciada por DelFiles e o arquivo estiver presente no sistema com uma assinatura válida, o sistema operacional poderá otimizar a operação de cópia, mas executar a operação de exclusão. Isso provavelmente não é o que o gravador INF pretendia.

Observação

Você não pode usar um token %strkey% para especificar a entrada destination-file-name. Para obter mais informações sobre %strkey% tokens, consulte Seção Cadeias de caracteres INF.

flag
Esse valor opcional pode ser um dos seguintes, expresso em notação hexadecimal, conforme mostrado aqui ou como um valor decimal:

0x00000001 (DELFLG_IN_USE)
Exclua o arquivo nomeado, possivelmente depois que ele foi usado durante o processo de instalação.

Definir esse valor de sinalizador em um INF enfileira a operação de exclusão de arquivos até que o sistema seja reiniciado se o arquivo fornecido não puder ser excluído porque ele está em uso enquanto esse INF está sendo processado. Caso contrário, esse arquivo não será excluído.

0x00010000 (DELFLG_IN_USE1) (Windows 2000 ou versões posteriores do Windows)
Esse sinalizador é uma versão de palavra alta do sinalizador DELFLG_IN_USE e tem a mesma finalidade e efeito. Esse sinalizador deve ser usado apenas em para instalações em sistemas baseados em NT.

Definir esse valor de sinalizador em um INF impede conflitos com o sinalizador COPYFLG_WARN_IF_SKIP em um INF com diretivas DelFiles e CopyFiles que fazem referência à mesma seção de lista de arquivos.

Comentários

Importante

Essa diretiva deve ser usada com cuidado. É altamente recomendável que você não use a diretiva DelFiles no arquivo INF para um driver de função de Plug and Play (PnP).

Qualquer nome de seção de lista de arquivos deve ser exclusivo para o arquivo INF, mas pode ser referenciado pelas diretivas CopyFiles, DelFiles ou RenFiles em outro lugar no mesmo INF. Esse nome de seção definido pelo gravador INF deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras de sintaxe geral para arquivos INF.

A diretiva DelFiles não dá suporte à decoração de um nome de seção de lista de arquivos com uma extensão de plataforma definida pelo sistema (.nt, .ntx86, .ntia64, .ntamd64, .ntarm ou .ntarm64).

A seção DestinationDirs do arquivo INF controla o destino de todas as operações de exclusão de arquivo, independentemente da seção que contém uma diretiva DelFiles específica. Se uma seção nomeada referenciada por uma diretiva DelFiles tiver uma entrada correspondente na seção DestinationDirs do mesmo INF, essa entrada especificará explicitamente o diretório de destino do qual todos os arquivos listados na seção nomeada serão excluídos. Se a seção nomeada não estiver listada na seção DestinationDirs , o Windows usará a entrada DefaultDestDir no INF.

Exemplos

Este exemplo mostra como a seção DestinationDirs especifica o caminho para uma operação delete-file que ocorre no processamento de um INF de driver de dispositivo simples.

[DestinationDirs]
DefaultDestDir = 12  ; DIRID_DRIVERS 

; ... 

[AHA154X]
CopyFiles=@AHA154x.MPD
DelFiles=ASPIDEV ; defines delete-files section name
; ... some other directives and sections omitted here

[ASPIDEV]
VASPID.SYS ; name of file to be deleted, if it exists on target 
; ...