INF-verzió szakasz

Konvenció szerint a Verzió szakasz először az INF-fájlokban jelenik meg. Minden INF-fájlnak rendelkeznie kell ezzel a szakaszlal.

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

Bejegyzések

Signature="signature-name"
$Windows NT$ vagy $Chicago$. Ez azokat az operációs rendszereket jelzi, amelyekre érvényes ez az INF. Ezek az aláírási értékek a következő jelentéssel rendelkeznek.

Aláírás értéke	Meaning
$Windows NT$	Minden Windows operációs rendszer
$Chicago$	Minden Windows operációs rendszer

A dollárjeljelek ($) megadása kötelező, de ezek a sztringek nem érzékenyek a kis- és nagybetűkre. Ha az aláírás-név nem tartozik ezek közé a sztringértékek közé, a fájl nem fogadható el érvényes INF-ként.

A Windows általában nem különbözteti meg ezeket az aláírási értékeket. Az egyiket meg kell adni, de nem számít, melyiket. Meg kell adnia a megfelelő értéket, hogy egy INF-fájlt olvasó személy meghatározhassa azokat az operációs rendszereket, amelyekhez a fájlt használni kívánja.

Egyes osztálytelepítők további követelményeket támasztanak az aláírási érték megadásának módjával kapcsolatban. Az ilyen követelményeket, ha léteznek, a Windows-illesztőprogramcsomag (WDK) eszköztípus-specifikus szakaszai ismertetik.

Az INF-nek rendszerspecifikus telepítési információkat kell megadnia a rendszer által definiált bővítmények DDInstall-szakaszaihoz való hozzáfűzésével, függetlenül attól, hogy az aláírás neve$Windows NT$ vagy $Chicago$. (A bővítmények ismertetését lásd: INF-fájlok létrehozása több platformhoz és operációs rendszerhez .)

Class=class-name
Minden szabványos eszköztípus esetében ez adja meg az eszköz beállítási osztályának a jelen INF-fájl használatával telepített eszköztípus nevét. Ez a név általában a rendszer által definiált osztálynevek egyike, például a Net vagy a Display, amelyek a Devguid.h-ban szerepelnek. További információ: System-Supplied eszközbeállítási osztályok.

Ha egy INF osztályt ad meg, meg kell adnia a megfelelő rendszer által definiált GUID-értéket is a ClassGUID bejegyzéshez. Az előre definiált eszközbeállítási osztályhoz tartozó eszközök megfelelő GUID-értékének megadásával gyorsabban telepítheti az eszközt és illesztőprogramjait, mivel ez segít a rendszer beállítási kódjának optimalizálásában az INF-keresésben.

Ha egy INF új eszközosztályt ad hozzá a rendszerhez, egy egyedi, kis- és nagybetűket nem megkülönböztető osztálynévértéket kell megadnia, amely különbözik a Devguid.h rendszer által biztosított osztályaitól. Az osztálynév sztringjének hossza legfeljebb 32 karakter lehet. Az INF-nek meg kell adnia egy újonnan létrehozott GUID-értéket a ClassGUID bejegyzéshez. Lásd még az INF ClassInstall32 szakaszt.

Ez a bejegyzés nem releváns az olyan INF-hez, amely nem telepít új eszközillesztőt egy előre definiált eszközbeállítási osztály vagy egy új eszközbeállítási osztály alá.

Note

Ez a bejegyzés a Plug and Play (PnP) kezelőn keresztül telepített eszközillesztőkhöz szükséges.

ClassGuid={nnnnnnnnnnnn--- nnnnn nnnn nn-}
Az eszközbeállítási osztály GUID azonosítójának megadása. A GUID érték az itt látható módon van formázva, ahol minden n egy hexadecimális számjegy.

Ez a GUID-érték az inf fájlból telepített eszközökhöz hozzárendelendő eszközbeállítási osztályt adja meg. Ez az osztályspecifikus GUID-érték az eszközosztály-telepítőt is azonosítja az eszköztípushoz és az osztályspecifikus tulajdonságlap-szolgáltatóhoz, ha van ilyen.

Új eszközbeállítási osztály esetén az INF-nek meg kell adnia egy újonnan létrehozott ClassGUID-értéket . A GRAFIKUS GUID-k létrehozásáról további információt a GUID-k használata illesztőprogramokban című témakörben talál. Lásd még az eszközbeállítási osztályokat.

Note

Ez a bejegyzés a PnP-kezelőn keresztül telepített eszközillesztőkhöz szükséges.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
Megadja a bővítményazonosító GUID azonosítóját egy bővítmény INF-fájljának létrehozásakor. A GUID érték az itt látható módon van formázva, ahol minden x egy hexadecimális számjegy.

A bővítmény INF kezdeti verziójának létrehozásakor az INF-nek meg kell adnia egy újonnan létrehozott ExtensionId-értéket . Egy meglévő bővítmény INF-jének frissítésekor azonban az ExtensionId-nek változatlannak kell maradnia, hogy a bővítmény INF több kapcsolódó verzióját egymás ellen verziószámozza ahelyett, hogy független bővítmény INF-ként kezelve lenne, amelyek egyidejűleg települhetnek ugyanazon az eszközpéldányon. További információ a bővítményEK INF-fájlok készítéséről: Bővítmény INF-fájl használata.

Note

Ez a bejegyzés csak a bővítmény INF létrehozásakor szükséges, a megadott Class = Extension és ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}a .

ClassVer=major.alverzió
Rendszerhasználatra van fenntartva, kivéve, ha egy eszközosztály, például a Nyomtató kifejezetten előírja. Lásd például a V4-illesztő INF-jét.

Provider=%INF-creator%
Azonosítja az INF-fájl szolgáltatóját. Ez általában egy %OrganizationName-jogkivonatként% van megadva, amelyet később kibontanak az INF-fájl Sztringek szakaszában. A szolgáltató nevének maximális hossza karakterben LINE_LEN.

A rendszer által biztosított INF-fájlok például általában msftként%% határozzák meg az INF-létrehozót, és a sztringszakaszokban definiálják % az Msft% = "Microsoft" értéket.

Note

Ez a bejegyzés a PnP-kezelőn keresztül telepített eszközillesztőkhöz szükséges.

CatalogFile=filename.cat
Katalógust (.cat) fájl, amelyet egy illesztőprogram-csomag terjesztési adathordozóján kell szerepeltetni.

Amikor egy illesztőprogram-csomagot digitális aláírás céljából küld a Microsoft, a WHQL katalógusfájlt biztosít az illesztőprogram-csomaghoz, miután a WHQL tesztelte és hozzárendelte a csomaghoz a digitális aláírásokat. Az IHV- vagy OEM-illesztőprogram-csomagok tesztelésével és aláírásával kapcsolatos további információkért lásd a WHQL kiadási aláírását. A katalógusfájlok nem szerepelnek az INF SourceDisksFiles vagy CopyFiles irányelvében. Windows feltételezi, hogy a katalógusfájl ugyanabban a helyen található, mint az INF-fájl.

A rendszer által biztosított INF-fájlok soha nem rendelkeznek CatalogFile= bejegyzésekkel, mert az operációs rendszer ellenőrzi az ilyen INF-fájlok aláírását az összes rendszer által biztosított xxx.cat fájlon.

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

Egy másik INF-writer által meghatározott egyedi fájlnevet ad meg a . cat extension, of a catalog file. Ha ezek az opcionális bejegyzések nincsenek megadva, a rendszer egy adott CatalogFile=filename.cat használ a WDM-eszközök/illesztőprogramok telepítésének ellenőrzéséhez.

Ha bármilyen díszített CatalogFile.xxx= bejegyzés létezik az INF Verzió szakaszában egy nemcorated CatalogFile= bejegyzéssel együtt, a rendszer feltételezi, hogy a be nem számolt bejegyzés azonosít egy filename.cat az eszköztelepítések, illesztőprogram-telepítések vagy mindkettő ellenőrzéséhez azokon a platformokon, amelyeken nincs megadva egy dekorált bejegyzés.

Minden platformfüggetlen eszközillesztő INF-fájl, amely CatalogFile= és CatalogFile fájllal rendelkezik.az xxx= bejegyzéseknek egyedi IHV/OEM által meghatározott nevet kell megadniuk minden ilyen .cat-fájlhoz.

További információ a rendszer által definiált .nt, .ntx86, .ntia64, .ntamd64, .ntarm és .ntarm64 bővítmények használatáról: INF-fájlok létrehozása több platformhoz és operációs rendszerhez.

Note

Mivel ugyanaz a .cat fájl minden támogatott platformon használható, a bejegyzés használata nem kötelező vagy ajánlott. Ezt a bejegyzést azonban akkor kell használnia, ha platformspecifikus .cat fájlokat szeretne létrehozni az illesztőprogram-csomaghoz.

DriverVer=mm/dd/yyyyy,w.x.y.z
Ez a bejegyzés az inf fájl által telepített illesztőprogramok verzióadatait adja meg. A 2000-Windows kezdve ez a bejegyzés kötelező.

A bejegyzés megadásáról további információt az INF DriverVer-irányelvben talál.

PnpLockDown=0|1
Megadja, hogy a Plug and Play (PnP) megakadályozza-e, hogy az alkalmazások közvetlenül módosítsák az illesztőprogram-csomag INF-fájljában megadott fájlokat. Ha a PnpLockDown direktíva értéke 1, a PnP megakadályozza, hogy az alkalmazások közvetlenül módosítsák az INF CopyFiles-irányelvek által másolt fájlokat. Ellenkező esetben, ha az irányelv nem szerepel egy INF-fájlban, vagy az irányelv értéke nullára van állítva, a rendszergazdai jogosultságokkal rendelkező alkalmazások közvetlenül módosíthatják ezeket a fájlokat. Az ilyen módon védett illesztőprogram-fájlokat külső féltől származó védett illesztőprogram-fájloknak nevezzük.

A PnP-illesztőprogramok telepítésének integritásának biztosítása érdekében az alkalmazásoknak nem szabad közvetlenül módosítaniuk az illesztőprogram-csomag INF-fájlja által másolt illesztőprogram-fájlokat. Az alkalmazások csak a Windows által biztosított eszköztelepítési mechanizmusokat használják a PnP-illesztőprogramok frissítéséhez.

A Windows Vista kezdve az illesztőprogram-csomagnak 1-re kell állítania a PnpLockDownt, hogy az alkalmazás ne módosíthassa közvetlenül az illesztőprogram-fájlokat. Az illesztőprogram-csomagokat eltávolító meglévő alkalmazások némelyike azonban közvetlenül törli az illesztőprogram-fájlokat. Az alkalmazásokkal való kompatibilitás fenntartása érdekében az ilyen illesztőprogram-csomag PnpLockDown-irányelvét nullára kell állítani.

Note

Bár az Windows Windows Vista és újabb verzióiban használt PnP nem követeli meg, hogy egy INF-fájl tartalmazzon egy PnpLockDown-irányelvet az illesztőprogram telepítéséhez, a PnP a Windows jövőbeli verziójában megkövetelheti, hogy a PnP-illesztőprogram-csomagok INF-fájljai tartalmazzák a PnpLockDown-irányelvet.

DriverPackageDisplayName=%driver-package-description%
Deprecated. Korábban az illesztőprogram-telepítési keretrendszerek (DIFx) használták. A DIFx-elavulással kapcsolatos információkért lásd a DIFx irányelveit.

DriverPackageType=PackageType
Deprecated. Korábban az illesztőprogram-telepítési keretrendszerek (DIFx) használták. A DIFx-elavulással kapcsolatos információkért lásd a DIFx irányelveit.

Remarks

Ha egy illesztőprogram-csomag megfelel Microsoft Windows Hardverminőségi tesztkörnyezet (WHQL) tesztelésének, a WHQL .cat katalógusfájlokat ad vissza az IHV-nek vagy az OEM-nek. Minden .cat-fájl tartalmaz egy digitálisan titkosított aláírást az illesztőprogram-csomaghoz. Az IHV-nek vagy az OEM-nek ezeket a .cat fájlokat az INF Verzió szakaszban kell listáznia, és a fájlokat a terjesztési adathordozón kell megadnia az INF-fájllal megegyező helyen. A .cat fájlokat tömörítetlennek kell lennie.

Note

Ha egy INF-verzió szakasz nem tartalmaz legalább egy CatalogFile vagy CatalogFile.nt xxx bejegyzést, a rendszer aláíratlanként kezeli az illesztőprogramot, és a DriverVer-irányelvben felsorolt dátumokat a Windows nem jeleníti meg.

További információ: Illesztőprogram-aláírás.

Examples

Az alábbi példa egy egyszerű illesztőprogram-csomagRA jellemző Verzió szakaszt mutat be, amelyet az ebben a mintaVerzió szakaszban megadott bejegyzések által megkövetelt SourceDisksNames és SourceDisksFiles szakaszok követnek:

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

Lásd még

DDInstall

SourceDisksNames

SourceDisksFiles

Sztringek