Sectie INF-versie

Volgens de conventie wordt de sectie Versie eerst weergegeven in INF-bestanden. Elk INF-bestand moet deze sectie hebben.

[Version]
 
Signature="signature-name"
[Class=class-name]
[ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn}]
[Provider=%INF-creator%]
[ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}]
[LayoutFile=filename.inf [,filename.inf]... ]  (Windows 2000 and Windows XP)
[CatalogFile=filename.cat]
[CatalogFile.nt=unique-filename.cat]
[CatalogFile.ntx86=unique-filename.cat]
[CatalogFile.ntia64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntamd64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntarm=unique-filename.cat]  (Windows 8 and later versions of Windows)
[CatalogFile.ntarm64=unique-filename.cat]  (Windows 10 version 1709 and later versions of Windows)

DriverVer=mm/dd/yyyy,w.x.y.z
[PnpLockDown=0|1] (Windows Vista and later versions of Windows)
[DriverPackageDisplayName=%driver-package-description%]
[DriverPackageType=PackageType]

Invoer

Signature="signature-name"
Moet $Windows NT$ of $Chicago$ zijn. Dit geeft de besturingssystemen aan waarvoor deze INF geldig is. Deze handtekeningwaarden hebben de volgende betekenissen.

Handtekeningwaarde	Meaning
$Windows NT$	Alle Windows besturingssystemen
$Chicago$	Alle Windows besturingssystemen

De tekens voor het insluiten van dollartekens ($) zijn vereist, maar deze tekenreeksen zijn hoofdlettergevoelig. Als de handtekeningnaam geen van deze tekenreekswaarden is, wordt het bestand niet geaccepteerd als een geldige INF.

Over het algemeen maakt Windows geen onderscheid tussen deze handtekeningwaarden. Een van deze moet worden opgegeven, maar het maakt niet uit welke. U moet de juiste waarde opgeven, zodat iemand die een INF-bestand leest, de besturingssystemen kan bepalen waarvoor het is bedoeld.

Sommige klasse-installatieprogramma's stellen aanvullende vereisten voor de wijze waarop de handtekeningwaarde moet worden opgegeven. Dergelijke vereisten, indien aanwezig, worden besproken in apparaattypespecifieke secties van deze Windows Driver Kit (WDK).

Een INF moet informatie over de installatie van het besturingssysteem opgeven door door het systeem gedefinieerde extensies toe te voegen aan de DDInstall-secties, ongeacht of de handtekeningnaam$Windows NT$ of $Chicago$ is. (Zie INF-bestanden maken voor meerdere platforms en besturingssystemen voor een bespreking van deze extensies.)

Class=class-name
Voor elk standaardtype apparaat geeft dit de naam op van de installatieklasse van het apparaat voor het type apparaat dat is geïnstalleerd met behulp van dit INF-bestand. Deze naam is meestal een van de door het systeem gedefinieerde klassenamen, zoals Net of Display, die worden vermeld in Devguid.h. Zie System-Supplied Apparaatinstallatieklassen voor meer informatie.

Als een INF een klasse opgeeft, moet deze ook de bijbehorende door het systeem gedefinieerde GUID-waarde voor de klasseGUID-vermelding opgeven. Als u de overeenkomende GUID-waarde voor een apparaat van een vooraf gedefinieerde apparaatinstallatieklasse opgeeft, kunnen het apparaat en de bijbehorende stuurprogramma's sneller worden geïnstalleerd, omdat hierdoor de systeeminstallatiecode wordt gebruikt om het zoeken in INF te optimaliseren.

Als een INF een nieuwe installatieklasse van apparaten toevoegt aan het systeem, moet deze een unieke, niet hoofdlettergevoelige klassenaamwaarde leveren die verschilt van een van de door het systeem geleverde klassen in Devguid.h. De lengte van de tekenreeks voor de klassenaam moet 32 tekens of minder zijn. De INF moet een zojuist gegenereerde GUID-waarde opgeven voor de klasseGUID-vermelding . Zie ook de sectie INF ClassInstall32.

Deze vermelding is niet relevant voor een INF die geen nieuw apparaatstuurprogramma installeert onder een vooraf gedefinieerde apparaatinstallatieklasse of een nieuwe apparaatinstallatieklasse.

Note

Deze vermelding is vereist voor apparaatstuurprogramma's die zijn geïnstalleerd via de Plug en Play (PnP)-beheer.

ClassGuid={nnnnnnnn-nnnn nnnn-nnnn-nnn- nnn}
Hiermee geeft u de GUID van de apparaatinstallatieklasse . De GUID-waarde wordt opgemaakt zoals hier wordt weergegeven, waarbij elke n een hexadecimaal cijfer is.

Deze GUID-waarde geeft de apparaatinstallatieklasse op die moet worden toegewezen aan apparaten die zijn geïnstalleerd vanuit dit INF-bestand. Deze klassespecifieke GUID-waarde identificeert ook het installatieprogramma van de apparaatklasse voor het type apparaat- en klassespecifieke eigenschappenpaginaprovider, indien van toepassing.

Voor een nieuwe apparaatinstallatieklasse moet de INF een zojuist gegenereerde ClassGUID-waarde opgeven. Zie GUID's gebruiken in stuurprogramma's voor meer informatie over het maken van GUID's. Zie ook Apparaatinstallatieklassen.

Note

Deze vermelding is vereist voor apparaatstuurprogramma's die zijn geïnstalleerd via PnP-beheer.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx}
Hiermee geeft u de extensie-ID GUID bij het ontwerpen van een extensie INF. De GUID-waarde wordt opgemaakt zoals hier wordt weergegeven, waarbij elke x een hexadecimaal cijfer is.

Bij het maken van de eerste versie van een extensie INF moet de INF een zojuist gegenereerde ExtensionId-waarde opgeven. Bij het bijwerken van een bestaande extensie INF moet de ExtensionId echter hetzelfde blijven, zodat meerdere gerelateerde versies van de extensie INF tegen elkaar worden geversied in plaats van als onafhankelijke extensie-INF's te worden behandeld die tegelijkertijd op hetzelfde apparaatexemplaren kunnen worden geïnstalleerd. Zie Een EXTENSIE INF-bestand gebruiken voor meer informatie over het schrijven van extensie-INF-bestanden.

Note

Deze vermelding is alleen vereist bij het maken van een extensie INF, zoals wordt aangegeven door op te geven Class = Extension en ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}.

ClassVer=major.secundair
Gereserveerd voor systeemgebruik, tenzij dit expliciet is vereist voor een apparaatklasse zoals Printer. Zie bijvoorbeeld V4 Driver INF.

Provider=%INF-creator%
Identificeert de provider van het INF-bestand. Dit wordt meestal opgegeven als een %OrganizationName-token% dat verderop in de sectie Tekenreeksen van het INF-bestand wordt uitgebreid. De maximale lengte, in tekens, van een providernaam is LINE_LEN.

INF-bestanden die bij het systeem worden geleverd, geven bijvoorbeeld de INF-maker meestal op als %Msft% en definiëren %Msft% = "Microsoft" in hun tekenreekssecties.

Note

Deze vermelding is vereist voor apparaatstuurprogramma's die zijn geïnstalleerd via PnP-beheer.

CatalogFile=bestandsnaam.cat
Hiermee geeft u een catalogus (.cat) bestand dat moet worden opgenomen op de distributiemedia van een stuurprogrammapakket.

Wanneer een stuurprogrammapakket wordt verzonden naar Microsoft voor digitale ondertekening, biedt WHQL een catalogusbestand voor het stuurprogrammapakket nadat WHQL digitale handtekeningen aan het pakket heeft getest en toegewezen. Zie WHQL Release Signature voor meer informatie over het testen en ondertekenen van IHV- of OEM-stuurprogrammapakketten. Catalogusbestanden worden niet vermeld in de sectie SourceDisksFiles of CopyFiles-instructie van de INF. Windows gaat ervan uit dat het catalogusbestand zich op dezelfde locatie bevindt als het INF-bestand.

Door het systeem geleverde INF-bestanden hebben nooit CatalogFile= vermeldingen omdat het besturingssysteem de handtekening voor een dergelijke INF valideert op basis van alle door het systeem geleverde xxx.cat bestanden.

CatalogFile.nt=unique-filename.cat |
CatalogFile.ntx86=unique-filename.cat |
CatalogFile.ntia64=unique-filename.cat |
CatalogFile.ntamd64=unique-filename.cat
CatalogFile.ntarm=unique-filename.cat
CatalogFile.ntarm64=unique-filename.cat

Hiermee geeft u een andere INF-writer-bepaald, unieke bestandsnaam, met de . cat-extensie , van een catalogusbestand. Als deze optionele vermeldingen worden weggelaten, wordt een opgegeven CatalogFile=filename.cat gebruikt voor het valideren van installaties van WDM-apparaten/stuurprogramma's.

Indien voorzien van een ingerichte CatalogFile.xxx-vermelding= bestaat in de sectie Versie van een INF, samen met een niet-geconconseerde CatalogFile= vermelding, de niet-geconseerde vermelding wordt ervan uitgegaan een filename.cat te identificeren voor het valideren van apparaatinstallaties, stuurprogramma-installaties of beide op die platforms waarvoor geen versieringsvermelding is opgegeven.

Elk platformoverschrijdend INF-bestand met CatalogFile= en CatalogFile.xxx= vermeldingen moeten een unieke IHV/OEM-bepaalde naam opgeven voor elk dergelijk .cat-bestand.

Zie INF-bestanden maken voor meerdere platforms en besturingssystemen voor meer informatie over het gebruik van de door het systeem gedefinieerde .nt, .ntnt, .ntarm, en .ntarm64.

Note

Omdat hetzelfde CAT-bestand op alle ondersteunde platforms kan worden gebruikt, is het gebruik van deze vermelding niet vereist of aanbevolen. U moet deze vermelding echter gebruiken als u platformspecifieke .cat-bestanden wilt maken voor uw stuurprogrammapakket.

DriverVer=mm/dd/jjjj,w.x.y.z
Met deze vermelding geeft u versie-informatie op voor stuurprogramma's die zijn geïnstalleerd door dit INF-bestand. Vanaf Windows 2000 is deze vermelding vereist.

Zie de INF DriverVer-richtlijn voor informatie over het opgeven van deze vermelding.

PnpLockDown=0|1
Hiermee geeft u op of Plug en Play (PnP) voorkomt dat toepassingen de bestanden die het INF-bestand van een stuurprogrammapakket specificeert, rechtstreeks wijzigen. Als de PnpLockDown-instructie is ingesteld op 1, voorkomt PnP dat toepassingen de bestanden die worden gekopieerd door INF CopyFiles-instructies rechtstreeks wijzigen. Als de richtlijn niet is opgenomen in een INF-bestand of de waarde van de richtlijn is ingesteld op nul, kan een toepassing met beheerdersbevoegdheden deze bestanden rechtstreeks wijzigen. Stuurprogrammabestanden die op deze manier zijn beveiligd, worden ook wel stuurprogrammabestanden van derden genoemd.

Om de integriteit van een PnP-stuurprogramma-installatie te waarborgen, mogen toepassingen stuurprogrammabestanden die worden gekopieerd door het INF-bestand van het stuurprogrammapakket niet rechtstreeks wijzigen. Toepassingen mogen alleen gebruikmaken van de mechanismen voor apparaatinstallatie die door Windows worden geleverd om PnP-stuurprogramma's bij te werken.

Vanaf Windows Vista moet een stuurprogrammapakket PnpLockDown instellen op 1 om te voorkomen dat een toepassing stuurprogrammabestanden rechtstreeks wijzigt. Sommige bestaande toepassingen die stuurprogrammapakketten verwijderen, verwijderen echter rechtstreeks stuurprogrammabestanden. Om compatibiliteit met deze toepassingen te behouden, moet de PnpLockDown-instructie voor een dergelijk stuurprogrammapakket worden ingesteld op nul.

Note

Hoewel PnP op Windows Vista en latere versies van Windows niet vereist dat een INF-bestand een PnpLockDown-instructie bevat om een stuurprogramma te installeren, kan PnP in een toekomstige versie van Windows vereisen dat INF-bestanden voor PnP-stuurprogrammapakketten de PnpLockDown-instructie bevatten.

DriverPackageDisplayName=%driver-package-description%
Deprecated. Werd eerder gebruikt door Driver Install Frameworks (DIFx). Zie DIFx-richtlijnen voor meer informatie over de afschaffing van DIFx.

DriverPackageType=PackageType
Deprecated. Werd eerder gebruikt door Driver Install Frameworks (DIFx). Zie DIFx-richtlijnen voor meer informatie over de afschaffing van DIFx.

Remarks

Wanneer een stuurprogrammapakket Microsoft Windows WHQL-tests (Hardware Quality Lab) doorgeeft, retourneert WHQL .cat-catalogusbestanden naar de IHV of OEM. Elk CAT-bestand bevat een digitaal versleutelde handtekening voor het stuurprogrammapakket. De IHV of OEM moet deze .cat-bestanden vermelden in de sectie INF-versie en moeten de bestanden op de distributiemedia opgeven, op dezelfde locatie als het INF-bestand. De .cat-bestanden moeten worden gedecomprimeerd.

Note

Als een INF-versiesectie niet ten minste één CatalogFile- of CatalogFile.ntxxx-vermelding bevat, wordt het stuurprogramma behandeld als niet-ondertekend en worden de datums die worden vermeld in de DriverVer-instructie niet weergegeven door Windows.

Zie Ondertekening van stuurprogramma's voor meer informatie.

Examples

In het volgende voorbeeld ziet u een versiesectie die typisch is voor een eenvoudig stuurprogrammapakket INF, gevolgd door de vereiste secties SourceDisksNames enSourceDisksFiles die worden geïmpliceerd door de vermeldingen die zijn opgegeven in deze voorbeeldversiesectie :

[Version]
Signature="$Windows NT$"
Class=SCSIAdapter
ClassGUID={4D36E97B-E325-11CE-BFC1-08002BE10318}
Provider=%INF_Provider%
CatalogFile=example.cat
DriverVer=01/29/2010,1.2.3.4
PnpLockdown=1

[SourceDisksNames]
;
; diskid = description[, [tagfile] [, <unused>, subdir]]
;
1 = %Disk_Description%,,,\WinNT

[SourceDisksFiles.x86]
;
; filename_on_source = diskID[, [subdir][, size]]
;
exampleDriver.sys = 1,\x86

; ...

[Strings]
INF_Provider="Contoso"
Disk_Description = "Contoso Drivers Disk"
; ...

Zie ook

DDInstall

SourceDisksNames

SourceDisksFiles

Tekenreeksen