Directive INF DelFiles

Article
03/08/2023

Attention

Si vous créez un package de pilote universel ou Windows, cette directive n’est pas valide. Consultez Utilisation d’un fichier INF universel et Prise en main avec des pilotes Windows.

Une directive DelFiles fait référence à une section définie par inf writer ailleurs dans le fichier INF et entraîne la suppression de cette liste de fichiers dans le contexte des opérations sur la section dans laquelle la directive DelFiles de référence est spécifiée.

[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]...

Une directive DelFiles peut être spécifiée dans l’une des sections affichées dans l’instruction syntaxique formelle. Cette directive peut également être spécifiée dans l’une des sections suivantes définies par l’enregistreur INF :

Section d’ajout d’interface référencée par la directive AddInterface dans un DDInstall. Section Interfaces .
Une section install-interface référencée dans une section InterfaceInstall32

Chaque section nommée référencée par une directive DelFiles a une ou plusieurs entrées de la forme suivante :

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

Une section de liste de fichiers peut avoir un nombre quelconque d’entrées, chacune sur une ligne distincte.

Entrées

destination-file-name
Spécifie le nom du fichier à supprimer de la destination.

Ne spécifiez pas un fichier répertorié dans une directive CopyFiles . Si un fichier est répertorié à la fois dans une section copyFiles référencée et une section référencée par DelFiles, et que le fichier est actuellement présent sur le système avec une signature valide, le système d’exploitation peut optimiser l’opération de copie, mais effectuer l’opération de suppression. Ce n’est probablement pas ce que l’enregistreur INF a prévu.

Notes

Vous ne pouvez pas utiliser un jeton %strkey% pour spécifier l’entrée destination-file-name. Pour plus d’informations sur les jetons %strkey%, consultez la section Chaînes INF.

flag
Cette valeur facultative peut être l’une des suivantes, exprimée en notation hexadécimale comme indiqué ici ou sous forme de valeur décimale :

0x00000001 (DELFLG_IN_USE)
Supprimez le fichier nommé, éventuellement après son utilisation pendant le processus d’installation.

La définition de cette valeur d’indicateur dans un INF met en file d’attente l’opération de suppression de fichier jusqu’à ce que le système ait redémarré si le fichier donné ne peut pas être supprimé, car il est en cours d’utilisation pendant le traitement de cet inf. Sinon, un tel fichier ne sera pas supprimé.

0x00010000 (DELFLG_IN_USE1) (Windows 2000 ou versions ultérieures de Windows)
Cet indicateur est une version haute de l’indicateur DELFLG_IN_USE, qui a le même objectif et le même effet. Cet indicateur doit être utilisé dans uniquement pour les installations sur des systèmes NT.

La définition de cette valeur d’indicateur dans un INF empêche les conflits avec l’indicateur COPYFLG_WARN_IF_SKIP dans un INF avec les directives DelFiles et CopyFiles qui font référence à la même section file-list.

Remarques

Important

Cette directive doit être utilisée avec précaution. Nous vous recommandons vivement de ne pas utiliser la directive DelFiles dans le fichier INF pour un pilote de fonction Plug-and-Play (PnP).

Tout nom de section de liste de fichiers doit être unique au fichier INF, mais il peut être référencé par les directives CopyFiles, DelFiles ou RenFiles ailleurs dans le même INF. Ce nom de section défini par l’enregistreur INF doit suivre les règles générales pour définir les noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.

La directive DelFiles ne prend pas en charge la décoration d’un nom de section de liste de fichiers avec une extension de plateforme définie par le système (.nt, .ntx86, .ntia64, .ntamd64, .ntarm ou .ntarm64).

La section DestinationDirs du fichier INF contrôle la destination de toutes les opérations de suppression de fichier, quelle que soit la section qui contient une directive DelFiles particulière. Si une section nommée référencée par une directive DelFiles a une entrée correspondante dans la section DestinationDirs du même INF, cette entrée spécifie explicitement le répertoire de destination cible à partir duquel tous les fichiers répertoriés dans la section nommée seront supprimés. Si la section nommée n’est pas répertoriée dans la section DestinationDirs , Windows utilise l’entrée DefaultDestDir dans l’INF.

Exemples

Cet exemple montre comment la section DestinationDirs spécifie le chemin d’une opération delete-file qui se produit dans le traitement d’un inf de pilote de périphérique simple.

[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 
; ...