INF DelFiles-direktiv

Caution

Om du skapar ett universellt eller Windows Drivrutinspaket är det här direktivet inte giltigt. Se Använda en Universell INF-fil och Kom igång med att utveckla Windows drivrutiner.

Ett DelFiles-direktiv refererar till ett INF-skrivardefinierat avsnitt någon annanstans i INF-filen och gör att listan över filer tas bort i samband med åtgärder i avsnittet där det refererande DelFiles-direktivet anges.

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

Ett DelFiles-direktiv kan anges i något av de avsnitt som visas i den formella syntaxsatsen. Det här direktivet kan också anges i något av följande INF-skrivardefinierade avsnitt:

Varje namngivet avsnitt som refereras till av ett DelFiles-direktiv har en eller flera poster i följande formulär:

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

Ett fil-list-avsnitt kan ha valfritt antal poster, var och en på en separat rad.

Inlägg

destination-file-name
Anger namnet på filen som ska tas bort från målet.

Ange inte en fil som visas i ett CopyFiles-direktiv . Om en fil visas i både ett CopyFiles-refererat och ett DelFiles-refererat avsnitt, och filen för närvarande finns i systemet med en giltig signatur, kan operativsystemet optimera bort kopieringsåtgärden men utföra borttagningsåtgärden. Detta är mycket troligt inte vad INF-skrivaren avsåg.

Note

Du kan inte använda en %strkey -% token för att ange posten destination-file-name. Mer information om %strkey -% token finns i avsnittet INF-strängar.

flag
Det här valfria värdet kan vara något av följande, uttryckt i hexadecimal notation som visas här eller som ett decimalvärde:

0x00000001 (DELFLG_IN_USE)
Ta bort den namngivna filen, eventuellt efter att den användes under installationsprocessen.

Om du anger det här flaggvärdet i en INF placeras filborttagningsåtgärden i kö tills systemet har startats om om den angivna filen inte kan tas bort eftersom den används medan inf-filen bearbetas. Annars tas en sådan fil inte bort.

0x00010000 (DELFLG_IN_USE1) (Windows 2000 eller senare versioner av Windows)
Den här flaggan är en högordsversion av flaggan DELFLG_IN_USE och har samma syfte och effekt. Den här flaggan bör endast användas i för installationer på NT-baserade system.

Om du anger det här flaggvärdet i en INF förhindras konflikter med flaggan COPYFLG_WARN_IF_SKIP i en INF med både DelFiles- och CopyFiles-direktiv som refererar till samma fillista.

Remarks

Important

Detta direktiv måste användas noggrant. Vi rekommenderar starkt att du inte använder DelFiles-direktivet i INF-filen för en technológia Plug and Play-funktionsdrivrutin (PnP).

Alla fillistavsnittsnamn måste vara unika för INF-filen, men det kan refereras till av CopyFiles-, DelFiles- eller RenFiles-direktiv någon annanstans i samma INF. Ett sådant INF-skrivskyddat avsnittsnamn måste följa de allmänna reglerna för att definiera avsnittsnamn. Mer information om dessa regler finns i Allmänna syntaxregler för INF-filer.

DelFiles-direktivet stöder inte att ett fillisteavsnittsnamn dekoreras med ett systemdefinierat plattformstillägg (.nt, .ntx86, .ntia64, .ntamd64, .ntarm eller .ntarm64).

Avsnittet DestinationDirs i INF-filen styr målet för alla filborttagningsåtgärder, oavsett vilket avsnitt som innehåller ett visst DelFiles-direktiv . Om ett namngivet avsnitt som refereras till av ett DelFiles-direktiv har en motsvarande post i avsnittet DestinationDirs i samma INF anger den posten uttryckligen målkatalogen från vilken alla filer som visas i det namngivna avsnittet tas bort. Om det namngivna avsnittet inte visas i avsnittet DestinationDirs använder Windows posten DefaultDestDir i INF.

Examples

Det här exemplet visar hur avsnittet DestinationDirs anger sökvägen för en borttagningsfilåtgärd som inträffar vid bearbetning av en enkel INF för enhetsdrivrutiner.

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

Se även

Lägg tillInterface

ClassInstall32

CopyFiles

DDInstall

DestinationDirs

InterfaceInstall32

RenFiles

Strängar