Oddíl verze INF

Podle konvence se oddíl Verze zobrazí jako první v souborech INF. Každý soubor INF musí mít tuto část.

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

Položky

Signature="signature-name"
Musí být $Windows NT$ nebo $Chicago$. Označuje operační systémy, pro které je tato inf platná. Tyto hodnoty podpisu mají následující významy.

Hodnota podpisu	Meaning
$Windows NT$	Všechny operační systémy Windows
$Chicago$	Všechny operační systémy Windows

Znaky znaku dolaru ($) jsou povinné, ale tyto řetězce nerozlišují malá a velká písmena. Pokud název podpisu neobsahuje žádné z těchto řetězcových hodnot, soubor není přijat jako platný inf.

Obecně platí, že Windows nerozlišuje mezi těmito hodnotami podpisu. Jeden z nich musí být zadán, ale nezáleží na tom, který z nich. Měli byste zadat odpovídající hodnotu, aby někdo, kdo čte soubor INF, mohl určit operační systémy, pro které je určen.

Některé instalační programy tříd umisťují další požadavky na to, jak musí být zadána hodnota podpisu. Tyto požadavky, pokud existují, jsou popsány v oddílech specifických pro zařízení tohoto Sada WDK (Windows Driver Kit).

Inf musí poskytovat informace o instalaci specifické pro operační systém připojením systémově definovaných rozšíření do oddílů DDInstall, bez ohledu na to, zda je název podpisu$Windows NT$ nebo $Chicago$. (Informace o těchto rozšířeních najdete v tématu Vytváření souborů INF pro více platforem a operačních systémů .)

Class=class-name
U jakéhokoli standardního typu zařízení určuje název třídy nastavení zařízení pro typ zařízení, které je nainstalováno pomocí tohoto souboru INF. Tento název je obvykle jedním ze systémově definovaných názvů tříd, například Net nebo Display, které jsou uvedeny v Devguid.h. Další informace najdete v tématu System-Supplied třídy nastavení zařízení.

Pokud INF určuje třídu, měla by také zadat odpovídající hodnotu GUID definovanou systémem pro její položku ClassGUID . Určení odpovídající hodnoty GUID pro zařízení libovolné předdefinované třídy nastavení zařízení může zařízení a jeho ovladače nainstalovat rychleji, protože to pomáhá kódu nastavení systému optimalizovat vyhledávání INF.

Pokud INF přidá do systému novou třídu nastavení zařízení, měla by poskytnout jedinečnou hodnotu názvu třídy bez rozlišování velkých a malých písmen, která se liší od kterékoli ze systémově zadaných tříd v Devguid.h. Délka řetězce názvu třídy musí být 32 znaků nebo menší. Inf musí zadat nově vygenerovanou hodnotu GUID pro položku ClassGUID . Viz také část INF ClassInstall32.

Tato položka není relevantní pro INF, která nainstaluje nový ovladač zařízení pod předdefinovanou třídou nastavení zařízení ani novou třídou nastavení zařízení.

Note

Tato položka se vyžaduje pro ovladače zařízení nainstalované prostřednictvím správce technologie Plug and Play (PnP).

ClassGuid={nnnnnnnn---- nn}
Určuje identifikátor GUID třídy nastavení zařízení . Hodnota GUID je naformátovaná, jak je znázorněno zde, kde každý n je šestnáctková číslice.

Tato hodnota GUID určuje třídu nastavení zařízení, která se mají přiřadit k zařízením nainstalovaným z tohoto souboru INF. Tato hodnota GUID specifická pro třídu také identifikuje instalační program třídy zařízení pro typ zařízení a poskytovatele stránky vlastností specifické pro třídu, pokud existuje.

Pro novou třídu nastavení zařízení musí INF zadat nově vygenerovanou hodnotu ClassGUID . Další informace o vytváření identifikátorů GUID naleznete v tématu Použití identifikátorů GUID v ovladačích. Viz také třídy nastavení zařízení.

Note

Tato položka se vyžaduje pro ovladače zařízení nainstalované prostřednictvím správce PnP.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
Určuje identifikátor GUID ID rozšíření při vytváření rozšíření INF. Hodnota GUID je formátována, jak je znázorněno zde, kde každá x je šestnáctková číslice.

Při vytváření počáteční verze inf rozšíření musí INF zadat nově vygenerovanou hodnotu ExtensionId . Při aktualizaci existujícího rozšíření INF však musí Id rozšíření zůstat stejné, aby více souvisejících verzí inf rozšíření bylo proti sobě, a ne jako nezávislé rozšíření INF, které mohou být současně nainstalovány ve stejné instanci zařízení. Další informace o tom, jak vytvořit přípony INFs, naleznete v tématu Použití souboru INF přípony.

Note

Tato položka je vyžadována pouze při vytváření rozšíření INF, jak je určeno zadáním Class = Extension a ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}.

ClassVer=major.podverze
Vyhrazeno pro použití systému, pokud to explicitně nevyžaduje třída zařízení, jako je tiskárna. Podívejte se například na soubor INF ovladače verze 4.

Provider=%INF-creator%
Identifikuje zprostředkovatele souboru INF. Obvykle se to zadává jako % token OrganizationName%, který se později rozbalí v části Řetězce souboru INF. Maximální délka názvu zprostředkovatele je LINE_LEN.

Například soubory INF dodané se systémem obvykle specifikují inf-creator jako %Msft a definují Msft %% = "Microsoft" v jejich částech Řetězce.%

Note

Tato položka se vyžaduje pro ovladače zařízení nainstalované prostřednictvím správce PnP.

CatalogFile=filename.cat
Určuje katalog (.cat) soubor, který má být součástí distribučního média balíčku ovladače.

Při odeslání balíčku ovladače do Microsoft pro digitální podepisování poskytuje WHQL soubor katalogu pro balíček ovladačů po otestování a přiřazení digitálních podpisů k balíčku. Další informace o testování a podepisování balíčků ovladačů IHV nebo OEM naleznete v tématu Podpis verze WHQL. Soubory katalogu nejsou uvedeny v části SourceDisksFiles nebo CopyFiles direktivy INF. Windows předpokládá, že soubor katalogu je ve stejném umístění jako soubor INF.

Systémové soubory INF nikdy nemají položky CatalogFile= , protože operační systém ověří podpis pro takový INF vůči všem souborům zadaným systémem xxx.cat .

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

Určuje jiný zapisovač INF, jedinečný název souboru s příponou . cat extension, of a catalog file. Pokud tyto volitelné položky vynecháte, použije se daná položka CatalogFile=filename.cat k ověřování instalací zařízení/ovladačů WDM.

Pokud některý z dekorovaný CatalogFile.Položka xxx= existuje v oddílu verze INF spolu s nezakódovanou položkou CatalogFile= položka, neověřená položka se předpokládá, že identifikuje filename.cat pro ověřování instalací zařízení, instalací ovladačů nebo obojího na těchto platformách, pro které není určena ozdobná položka.

Jakýkoli soubor INF ovladače zařízení pro různé platformy, který obsahuje CatalogFile= a CatalogFile.xxx= položky musí obsahovat jedinečný název IHV/OEM určený pro každý takový soubor .cat.

Další informace o použití souborů .nt, .ntx86, .ntia64, .ntamd64, .ntarm a .ntarm64 naleznete v tématu Vytváření souborů INF pro více platforem a operačních systémů.

Note

Vzhledem k tomu, že stejný soubor .cat lze použít na všech podporovaných platformách, použití této položky není vyžadováno nebo doporučeno. Tuto položku však musíte použít, pokud chcete pro balíček ovladače vytvořit soubory .cat specifické pro platformu.

DriverVer=mm/dd/yy,w.x.y.z
Tato položka určuje informace o verzi pro ovladače, které jsou nainstalovány tímto souborem INF. Od Windows 2000 je tato položka povinná.

Informace o tom, jak tuto položku zadat, naleznete v tématu INF DriverVer – direktiva.

PnpLockDown=0|1
Určuje, zda technologie Plug and Play (PnP) brání aplikacím v přímé úpravě souborů, které určuje soubor INF balíčku ovladače. Pokud je direktiva PnpLockDown nastavena na 1, PnP zabraňuje aplikacím v přímé úpravě souborů, které jsou zkopírovány direktivami INF CopyFiles . V opačném případě, pokud direktiva není zahrnuta do souboru INF nebo hodnota direktivy je nastavena na nulu, může aplikace s oprávněními správce tyto soubory přímo upravit. Soubory ovladačů, které jsou tímto způsobem chráněné, se označují jako soubory ovladačů chráněné třetí stranou.

Aby se zajistila integrita instalace ovladače PnP, neměly by aplikace přímo upravovat soubory ovladačů, které jsou zkopírovány souborem INF balíčku ovladače. Aplikace by měly používat pouze mechanismy instalace zařízení poskytované Windows k aktualizaci ovladačů PnP.

Počínaje Windows Vista by měl balíček ovladače nastavit PnpLockDown na hodnotu 1, aby aplikace nemohla přímo upravovat soubory ovladačů. Některé existující aplikace, které odinstalují balíčky ovladačů, však přímo odstraňují soubory ovladačů. Kvůli zachování kompatibility s těmito aplikacemi by direktiva PnpLockDown pro takový balíček ovladačů měla být nastavena na nulu.

Note

Přestože PnP na Windows Vista a novějších verzích Windows nevyžaduje, aby soubor INF obsahoval direktivu PnpLockDown pro instalaci ovladače, PnP v budoucí verzi Windows může vyžadovat, aby soubory INF pro balíčky ovladačů PnP obsahovaly direktivu PnpLockDown.

DriverPackageDisplayName=%driver-package-description%
Deprecated. Dříve používala rozhraní DIFx (Driver Install Frameworks). Informace o vyřazení DIFx naleznete v tématu DiFx Guidelines.

DriverPackageType=PackageType
Deprecated. Dříve používala rozhraní DIFx (Driver Install Frameworks). Informace o vyřazení DIFx naleznete v tématu DiFx Guidelines.

Remarks

Když balíček ovladače projde testováním Microsoft Windows Hardware Quality Lab (WHQL), vrátí WHQL soubory katalogu .cat do IHV nebo OEM. Každý soubor .cat obsahuje digitálně šifrovaný podpis balíčku ovladače. IHV nebo OEM musí vypsat tyto soubory .cat v části Verze INF a musí zadat soubory na distribučním médiu ve stejném umístění jako soubor INF. Soubory .cat musí být nekomprimované.

Note

Pokud oddíl verze INF neobsahuje alespoň jednu položku CatalogFile nebo CatalogFile.ntxxx, ovladač je považován za nepodepsaný a data uvedená v direktivě DriverVer nejsou zobrazena Windows.

Další informace naleznete v tématu Podepisování ovladačů.

Examples

Následující příklad ukazuje část verze typická pro soubor INF balíčku jednoduchého ovladače následované požadovanými oddíly SourceDisksNames a SourceDisksFiles odvozenými položkami zadanými v této ukázkové části Verze :

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

Viz také

DDInstall

SourceDisksNames

SourceDisksFiles

Řetězce