Sectie INF DDInstall

Artikel
01/11/2025

Elke sectie per model DDInstall bevat een optionele DriverVer-instructie en een of meer instructies die verwijzen naar extra benoemde secties in het INF-bestand, die hier worden weergegeven met de meest opgegeven INF-instructies, CopyFiles en AddReg, die als eerste worden vermeld.

De secties waarnaar in deze instructies wordt verwezen, bevatten instructies voor het installeren van stuurprogrammabestanden en het schrijven van apparaatspecifieke en/of stuurprogrammaspecifieke informatie in het register.

[install-section-name] | 
[install-section-name.nt] | 
[install-section-name.ntx86] | 
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)

[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]

Posten

Niet alle geldige vermeldingen worden ondersteund in een Universele INF-. In de volgende lijsten ziet u welke richtlijnen geldig zijn in een universele INF en die niet.

Ondersteund in een universele INF

DriverVer=mm/dd/jjjj[,x.y.v.z]
Deze optionele vermelding geeft versie-informatie op voor het stuurprogrammapakket.

Zie INF DriverVer Directivevoor meer informatie over het opgeven van deze vermelding.

CopyFiles=@bestandsnaam | file-list-section[,file-list-section] ...
Deze richtlijn geeft aan dat een benoemd bestand moet worden gekopieerd van de bronmedia naar de bestemming of verwijst naar een of meer INF-writer-gedefinieerde secties waarin apparaat relevante bestanden op de bronmedia worden opgegeven voor overdracht naar de bestemming. De CopyFiles instructie is optioneel, maar is aanwezig in de meeste DDInstall secties.

De DefaultDestDir vermelding in de DestinationDirs sectie van de INF geeft de bestemming op voor een enkel bestand dat moet worden gekopieerd. De en SourceDisksFiles secties, of een extra INF die is opgegeven in de LayoutFile vermelding van de versie sectie van deze INF, geeft de locatie op op de distributiemedia van de stuurprogrammabestanden.

Zie INF CopyFiles Directivevoor meer informatie.

CopyINF=bestandsnaam1.inf[,bestandsnaam2.inf]...
(Windows XP en hoger) Deze richtlijn zorgt ervoor dat opgegeven INF-bestanden naar het doelsysteem worden gekopieerd.

Zie INF CopyINF Directivevoor meer informatie.

AddReg=add-registry-section[,add-registry-section]...
Deze richtlijn verwijst naar een of meer inF-schrijver gedefinieerde secties waarin nieuwe subsleutels, mogelijk met initiële waardevermeldingen, in het register moeten worden geschreven of waarin de waardevermeldingen van bestaande sleutels worden gewijzigd.

Een HKR- specificatie in een dergelijke sectie van het add-registry wijst het 'softwaresleutel' registerpad aan van het apparaat dat wordt geïnstalleerd.

Zie INF AddReg Directivevoor meer informatie.

AddProperty=add-property-section[,add-property-section]...
(Windows Vista en hoger) Verwijst naar een of meer INF-bestandssecties die apparaateigenschappen wijzigen die zijn ingesteld voor een apparaatexemplaren. U moet een INF AddProperty-instructie alleen gebruiken om een eigenschap van een apparaatexemplaren in te stellen die nieuw is voor Windows Vista of latere versies van Windows-besturingssystemen.

Voor eigenschappen van het apparaatexemplaren die eerder zijn geïntroduceerd in Windows Server 2003, Windows XP of Windows 2000 en die overeenkomende registervermeldingswaarden, moet u INF AddReg-instructies blijven gebruiken om de eigenschappen van het apparaatexemplaren in te stellen. Deze richtlijnen zijn van toepassing op door het systeem gedefinieerde eigenschappen en aangepaste eigenschappen. Zie De INF AddProperty-richtlijn en de INF DelProperty-richtlijn gebruikenvoor meer informatie over het gebruik van de AddProperty-richtlijn van AddPropert y.

Include=bestandsnaam1.inf[,bestandsnaam2.inf]...
Met deze optionele vermelding geeft u een of meer extra DOOR het systeem geleverde INF-bestanden op die secties bevatten die nodig zijn om dit apparaat en/of stuurprogramma te installeren. Als deze vermelding is opgegeven, is dit meestal een Vereist vermelding.

InF-bestanden voor apparaatstuurprogramma's die afhankelijk zijn van de kernelstreaming-ondersteuning van het systeem, kan deze vermelding bijvoorbeeld als volgt opgeven:

Include= ks.inf, kscaptur.inf, ksfilter.inf

Needs=inf-section-name[,inf-section-name]...
Deze optionele vermelding bevat secties in door het systeem geleverde INF-bestanden die moeten worden verwerkt tijdens de installatie van dit apparaat. Normaal gesproken is een dergelijke benoemde sectie een DDInstall (of DDInstall.xxx) sectie binnen een van de INF-bestanden die worden vermeld in een opnemen vermelding. Het kan echter elke sectie zijn waarnaar wordt verwezen binnen een dergelijke DDInstall- of DDInstall-.xxx sectie van de opgenomen INF.

InF-bestanden voor apparaatstuurprogramma's met de voorgaande Inclusief vermelding kan deze vermelding bijvoorbeeld als volgt opgeven:

Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation

FeatureScore=featurescore

Waarschuwing

De FeatureScore instructie wordt alleen verwerkt wanneer deze rechtstreeks in de sectie [DDInstall] is opgegeven.

(Windows Vista en hoger) Deze richtlijn biedt een extra classificatiecriterium voor stuurprogramma's die zijn gebaseerd op de functies die een stuurprogramma ondersteunt. Functiescores kunnen bijvoorbeeld worden gedefinieerd voor een apparaatinstallatieklasse die onderscheid maakt tussen stuurprogramma's op basis van klassespecifieke criteria.

Zie How Windows Ranks Drivers (Windows Vista and Later)voor meer informatie over hoe stuurprogramma's worden gerangschikt.

Zie INF FeatureScore Directivevoor meer informatie over deze richtlijn.

Notitie

Hoewel een DDInstall sectie meerdere FeatureScore vermeldingen kan bevatten, wordt alleen de eerste vermelding voor de sectie verwerkt.

ExcludeID=device-identification-string[,device-identification-string]...

Waarschuwing

De ExcludeID instructie wordt alleen verwerkt wanneer deze rechtstreeks in de [DDInstall] sectie is opgegeven.

(Windows XP en hoger) Deze richtlijn specificeert een of meer apparaatidentificatietekenreeksen (hardware-id's of compatibele id's). De sectie DDInstall installeert geen apparaten met apparaat-id's die overeenkomen met een van de vermelde hardware-id's of compatibele id's.

opnieuw opstarten
Deze richtlijn geeft aan dat de beller moet worden gevraagd het systeem opnieuw op te starten nadat de installatie is voltooid.

Zie INF-herstartrichtlijnvoor meer informatie.

Niet ondersteund in een Universele INF

Delfiles=file-list-section[,file-list-section]...
Deze richtlijn verwijst naar een of meer door INF-writer gedefinieerde secties met bestanden op het doel dat moet worden verwijderd.

Zie INF DelFiles Directivevoor meer informatie.

Renfiles=file-list-section[,file-list-section]...
Deze richtlijn verwijst naar een of meer inF-schrijver gedefinieerde secties met bestanden die op de bestemming moeten worden hernoemd voordat apparaat relevante bronbestanden naar de doelcomputer worden gekopieerd.

Zie INF RenFiles Directivevoor meer informatie.

DelReg=del-registry-section[,del-registry-section]...
Deze richtlijn verwijst naar een of meer inF-schrijver gedefinieerde secties waarin sleutels en/of waardevermeldingen worden opgegeven die tijdens de installatie van de apparaten uit het register moeten worden verwijderd.

Deze instructie wordt doorgaans gebruikt voor het afhandelen van upgrades wanneer een INF oude registervermeldingen moet opschonen van een eerdere installatie van dit apparaat.

Een HKR specificatie in een dergelijke sectie voor verwijderen-register wijst de 'softwaresleutel' registerpad van het apparaat dat wordt geïnstalleerd.

Zie INF DelReg Directivevoor meer informatie.

DelProperty=del-property-section[,del-property-section]...
(Windows Vista en hoger) Verwijst naar een of meer INF-bestandssecties die apparaateigenschappen verwijderen die zijn ingesteld voor een apparaatexemplaren. U moet een INF DelProperty-instructie gebruiken alleen om een eigenschap van een apparaatexemplaren te verwijderen die nieuw is voor Windows Vista of latere versies van Windows.

Voor eigenschappen van het apparaatexemplaren die eerder zijn geïntroduceerd in Windows Server 2003, Windows XP of Windows 2000 en die overeenkomende registervermeldingswaarden, moet u INF DelReg-instructies blijven gebruiken om de eigenschappen van het apparaatexemplaren te verwijderen. Deze richtlijnen zijn van toepassing op door het systeem gedefinieerde eigenschappen en aangepaste eigenschappen. Zie De INF AddProperty-richtlijn en de INF DelPropert y-richtlijn gebruikenvoor meer informatie over het gebruik van de DelProperty-richtlijn van DelProperty.

BitReg=bit-registry-section[,bit-registry-section]...
Deze richtlijn verwijst naar een of meer inF-schrijver gedefinieerde secties waarin bestaande registerwaardevermeldingen van het type REG_BINARY worden gewijzigd.

Een HKR specificatie in een dergelijke bitregistersectie wijst de 'softwaresleutel' registerpad aan van het apparaat dat wordt geïnstalleerd.

Zie INF BitReg Directivevoor meer informatie.

LogConfig=log-config-section[,log-config-section]...
Deze richtlijn verwijst naar een of meer door INF gedefinieerde secties in een INF voor een apparaat met hoofdmaps of voor een handmatig geïnstalleerd apparaat. In deze benoemde secties geeft de INF voor een dergelijk 'gedetecteerd' of handmatig geïnstalleerd apparaat een of meer logische configuraties van bus-relatieve hardwareresources op die het apparaat moet operationeel zijn. De INF voor een dergelijk handmatig geïnstalleerd apparaat dat niet software configureerbaar is, moet ook een DDInstall-hebben. Sectie FactDef.

De LogConfig instructie wordt nooit gebruikt om Plug and Play-apparaten (PnP) te installeren. U kunt echter een sectie INF DDInstall.LogConfigOverride gebruiken om een onderdrukkingsconfiguratie voor PnP-apparaten te bieden.

Deze richtlijn is niet relevant voor alle stuurprogramma's en onderdelen op een hoger niveau.

Zie INF LogConfig Directivevoor meer informatie.

ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 en nieuwere versies van Windows) Deze zelden gebruikte instructie verwijst naar een of meer inF-schrijver gedefinieerde secties waarin items worden beschreven die moeten worden toegevoegd aan of verwijderd uit het menu Start.

Zie INF ProfileItems Directivevoor meer informatie.

UpdateInis=update-ini-section[,update-ini-section]...
Deze zelden gebruikte instructie verwijst naar een of meer INF-writer-gedefinieerde secties, waarbij een bron-INI-bestand wordt opgegeven waaruit een bepaalde sectie of regel in een dergelijke sectie moet worden gelezen in een doel-INI-bestand met dezelfde naam tijdens de installatie. Desgewenst kunnen in de sectie update-ini line wijzigingen in een bestaand INI-bestand op de bestemming van een bepaald BRON-INI-bestand met dezelfde naam worden opgegeven.

Zie INF UpdateInis Directivevoor meer informatie.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Deze zelden gebruikte instructie verwijst naar een of meer inF-schrijver gedefinieerde secties waarin wijzigingen binnen de regels van een apparaatspecifiek INI-bestand worden opgegeven.

Zie INF UpdateIniFields Directivevoor meer informatie.

Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Deze zelden gebruikte instructie verwijst naar een of meer inF-schrijver gedefinieerde secties waarin secties of regels van een apparaatspecifiek INI-bestand, dat op de bronmedia wordt geleverd, naar het register moeten worden verplaatst.

Zie INF Ini2Reg Directivevoor meer informatie.

RegisterDlls=register-dll-section[,register-dll-section]...
Deze richtlijn verwijst naar een of meer INF-secties die worden gebruikt om bestanden op te geven die OLE-besturingselementen zijn en waarvoor zelfregistratie is vereist.

Zie INF RegisterDlls Directivevoor meer informatie.

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Deze richtlijn verwijst naar een of meer INF-secties die worden gebruikt om bestanden op te geven die OLE-besturingselementen zijn en waarvoor zelfuitschrijving (zelfverwijdering) is vereist.

Zie INF UnregisterDlls Directivevoor meer informatie.

Opmerkingen

In de documentatie van de Windows Driver Kit (WDK) wordt de term DDInstall- gebruikt om te verwijzen naar een installatiesectienaam, met of zonder platformextensies. Daarom betekent 'DDInstall-sectie' 'een benoemde sectie in een INF, met de indeling [install-section-name] of [install-section-name.ntxxx]'. Wanneer u namen maakt voor DDInstall secties, moet u een apparaatspecifiek voorvoegsel opnemen, zoals [WDMPNPB003_Device] of [GPR400. Install.NT].

Elke DDInstall sectie moet worden verwezen in een apparaat-/modelspecifieke vermelding onder de INF Modellen sectie van het INF-bestand.

Behalve voor apparaten die geen gekoppelde bestanden hebben die moeten worden overgedragen vanaf de bronmedia, moet een INF-bestand dat een WDM-stuurprogramma installeert op verschillende besturingssysteemplatforms ten minste een van de volgende DDInstall- secties hebben:

Een installatiesectienaamsectie .ntx86 waarin de vermeldingen worden opgegeven voor apparaat-/stuurprogramma-installaties die specifiek zijn voor x86-platforms.
Een install-section-name.ntia64 sectie die de vermeldingen voor apparaat-/stuurprogramma-installaties specificeert die specifiek zijn voor Op Itanium gebaseerde platforms.
Een installatiesectienaamsectie .ntamd64 die de vermeldingen voor apparaat-/stuurprogramma-installaties specificeert die specifiek zijn voor x64-platforms.
Een installatiesectienaamsectie .ntarm die de vermeldingen voor apparaat-/stuurprogramma-installaties specificeert die specifiek zijn voor arm-platforms.
Een installatiesectienaamsectie .ntarm64 waarin de vermeldingen worden opgegeven voor apparaat-/stuurprogramma-installaties die specifiek zijn voor platformen op basis van Arm64.
Een installatiesectienaam of installatiesectienaamsectie .nt waarin de vermeldingen voor apparaat-/stuurprogramma-installaties worden opgegeven die niet specifiek zijn voor een bepaald hardwareplatform.

Voor meer informatie over het gebruik van de door het systeem gedefinieerde .nt, .ntx86, .ntia64, .ntamd64, .ntarmen .ntarm64 extensies, zie INF-bestanden maken voor meerdere platforms en besturingssystemen.

Vanaf Windows 2000 moet een INF-bestand dat stuurprogramma's installeert DDInstall.Services secties hebben om informatie over stuurprogrammaservice op te geven.

Elke instructie in een DDInstall sectie kan verwijzen naar meer dan één sectienaam. Elke extra benoemde sectie moet echter worden gescheiden van de volgende met een komma (,).

Elke sectienaam moet uniek zijn binnen het INF-bestand en moet voldoen aan de algemene regels voor het definiëren van sectienamen. Zie Algemene syntaxisregels voor INF-bestandenvoor meer informatie over deze regels.

Elke AddReg-instructie die is opgegeven in een DDInstall- sectie wordt ervan uitgegaan dat wordt verwezen naar een sectie met een invoegtoepassing die niet kan worden gebruikt voor het opslaan van informatie over stuurprogramma's met boven- of onderfilters, over multifunctionele apparaten of over stuurprogramma-onafhankelijke maar apparaatspecifieke parameters. Als een apparaat/stuurprogramma INF dit type informatie in het register moet opslaan, moet deze een AddReg--instructie gebruiken in de niet-geconconseerde en versierde DDInstall-. HW secties, indien aanwezig, om te verwijzen naar een andere INF-writer-gedefinieerde add-registry-section.

Afhankelijk van de apparaatinstallatieklasse die is opgegeven in de sectie INF-versie, kunnen aanvullende klassespecifieke instructies worden opgegeven in een sectie DDInstall. Zie de volgende onderwerpen voor meer informatie over klassespecifieke instructies:

Voorbeelden

In dit voorbeeld ziet u de uitbreiding van de secties DDInstall, Ser_Inst en Inp_Inst. Naar deze secties wordt verwezen in het voorbeeld voor de sectie INF Modellen.

[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles

[Ser_CopyFiles]
sermouse.sys

[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys

[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles

[Inp_CopyFiles]
inport.sys

In het volgende voorbeeld ziet u de sectie DDInstall van een INF-bestand dat een door het systeem geleverd WDM-stuurprogramma installeert voor een audioapparaat op verschillende besturingssysteemplatforms:

[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg

In het volgende voorbeeld ziet u de secties waarnaar wordt verwezen door de voorgaande Needs vermelding in de door het systeem geleverde ks.inf- en wdmaudio.inf--bestanden. In het voorgaande voorbeeld worden deze bestanden opgegeven in de Bevat vermelding. Wanneer het installatieprogramma van het besturingssysteem de installatiesectienaam van dit apparaat verwerkt. sectie worden deze volgende twee secties ook verwerkt.

[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
    TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
    DeviceRegistration 
CopyFiles=KSProxy.Files,KSDriver.Files

[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;