INF Sürümü bölümü

Kural gereği , Sürüm bölümü ILK olarak INF dosyalarında görünür. Her INF dosyasının bu bölümü olmalıdır.

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

Giriş

Signature="signature-name"
$Windows NT$ veya $Chicago$ olmalıdır. Bu, bu INF'nin geçerli olduğu işletim sistemlerini gösterir. Bu imza değerleri aşağıdaki anlamlara sahiptir.

İmza değeri	Meaning
$Windows NT$	Tüm Windows işletim sistemleri
$Chicago$	Tüm Windows işletim sistemleri

Kapsayan dolar işareti karakterleri ($) gereklidir, ancak bu dizeler büyük/küçük harfe duyarlı değildir. İmza-adı bu dize değerlerinden hiçbiri değilse, dosya geçerli bir INF olarak kabul edilmemektedir.

Genellikle, Windows bu imza değerleri arasında ayrım yapmaz. Bunlardan biri belirtilmelidir, ancak hangisinin olduğu önemli değildir. INF dosyasını okuyan birinin amaçlandığı işletim sistemlerini belirleyebilmesi için uygun değeri belirtmeniz gerekir.

Bazı sınıf yükleyicileri, imza değerinin nasıl belirtilmesi gerektiğine ilişkin ek gereksinimler koyar. Bu gereksinimler varsa, bu Windows Sürücü Seti (WDK) cihaz türüne özgü bölümlerinde ele alınmaktadır.

inf, sistem tanımlı uzantıları DDInstall bölümlerine ekleyerek işletim sistemine özgü yükleme bilgileri sağlamalıdır. İmza-adı$Windows NT$ veya $Chicago$ olmalıdır. (Bu uzantıların tartışılması için bkz . Birden Çok Platform ve İşletim Sistemi için INF Dosyaları Oluşturma .)

Class=class-name
Herhangi bir standart cihaz türü için, bu INF dosyası kullanılarak yüklenen cihaz türü için cihaz kurulum sınıfının adını belirtir. Bu ad genellikle Devguid.h dosyasında listelenen Net veya Display gibi sistem tanımlı sınıf adlarından biridir. Daha fazla bilgi için bkz. System-Supplied Cihaz Kurulum Sınıfları.

BIR INF bir Sınıf belirtiyorsa, classGUID girdisi için ilgili sistem tanımlı GUID değerini de belirtmelidir. Önceden tanımlanmış herhangi bir cihaz kurulum sınıfının cihazı için eşleşen GUID değerinin belirtilmesi, sistem kodunun INF aramasını iyileştirmesine yardımcı olduğundan cihazı ve sürücülerini daha hızlı yükleyebilir.

BIR INF sisteme yeni bir cihaz kurulum sınıfı eklerse, Devguid.h içindeki sistem tarafından sağlanan sınıflardan farklı benzersiz, büyük/küçük harfe duyarlı olmayan bir sınıf adı değeri sağlamalıdır. Sınıf adı dizesinin uzunluğu 32 karakter veya daha az olmalıdır. INF, ClassGUID girdisi için yeni oluşturulan bir GUID değeri belirtmelidir. Ayrıca bkz. INF ClassInstall32 Bölümü.

Bu giriş, önceden tanımlanmış bir cihaz kurulum sınıfı altına yeni bir cihaz sürücüsü veya yeni bir cihaz kurulum sınıfı yükleyen bir INF ile ilgisizdir.

Note

Bu giriş, Tak ve Kullan (PnP) yöneticisi aracılığıyla yüklenen cihaz sürücüleri için gereklidir.

ClassGuid={nnnnnnnn-nnnn-nn-nn-}
Cihaz kurulum sınıfı GUID'sini belirtir. GUID değeri burada gösterildiği gibi biçimlendirilir; burada her n onaltılık bir basamaktır.

Bu GUID değeri, bu INF dosyasından yüklenen cihazlara atanacak cihaz kurulum sınıfını belirtir. Bu sınıfa özgü GUID değeri, varsa cihaz türü ve sınıfa özgü özellik sayfası sağlayıcısı için cihaz sınıfı yükleyicisini de tanımlar.

Yeni bir cihaz kurulum sınıfı için INF'nin yeni oluşturulan bir ClassGUID değeri belirtmesi gerekir. GUID oluşturma hakkında daha fazla bilgi için bkz. Sürücülerdeki GUID'leri kullanma. Ayrıca bkz. Cihaz Kurulum Sınıfları.

Note

Bu giriş, PnP yöneticisi aracılığıyla yüklenen cihaz sürücüleri için gereklidir.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxx}
Bir uzantı INF'si yazarken uzantı kimliği GUID'sini belirtir. GUID değeri burada gösterildiği gibi biçimlendirilir ve burada her x onaltılık bir basamaktır.

Bir uzantı INF'sinin ilk sürümünü oluştururken, INF'nin yeni oluşturulan bir ExtensionId değeri belirtmesi gerekir. Ancak, mevcut bir uzantı INF'sini güncelleştirirken ExtensionId aynı kalarak uzantı INF'sinin birden çok ilişkili sürümünün aynı cihaz örneğine aynı anda yüklenebilen bağımsız uzantı INF'leri olarak kabul edilmesi yerine birbiriyle ilişkili sürümlerinin birbirleri üzerinde olması gerekir. Uzantı INF'leri yazma hakkında daha fazla bilgi için bkz. Uzantı INF Dosyası Kullanma.

Note

Bu giriş yalnızca ve ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}belirterek Class = Extension tanımlanan bir uzantı INF'i oluştururken gereklidir.

ClassVer=major.küçük
Yazıcı gibi bir cihaz sınıfı tarafından açıkça gerekli kılınmadığı sürece sistem kullanımı için ayrılmıştır. Örneğin bkz. V4 Sürücü INF.

Provider=%INF oluşturucusu%
INF dosyasının sağlayıcısını tanımlar. Genellikle bu, INF dosyasının Dizeler bölümünde daha sonra genişletilmiş bir %OrganizationName% belirteci olarak belirtilir. Bir sağlayıcı adının karakter cinsinden uzunluk üst sınırı LINE_LEN.

Örneğin, sistemle birlikte sağlanan INF dosyaları genellikle INF oluşturucuyuMsft% olarak% belirtir ve Dizeler bölümlerinde Msft% = "Microsoft" tanımlar%.

Note

Bu giriş, PnP yöneticisi aracılığıyla yüklenen cihaz sürücüleri için gereklidir.

CatalogFile=filename.cat
Bir katalog (.cat) dosyasının bir sürücü paketinin dağıtım medyasına eklenmesini sağlayın.

Bir sürücü paketi dijital imzalama için Microsoft gönderildiğinde WHQL, WHQL test ettikten ve pakete dijital imzalar atadıktan sonra sürücü paketi için bir katalog dosyası sağlar. IHV veya OEM sürücü paketlerinin test edilmesi ve imzalanması hakkında daha fazla bilgi için bkz. WHQL Yayın İmzası. Katalog dosyaları, INF'nin SourceDisksFiles bölümünde veya CopyFiles yönergesinde listelenmez. Windows katalog dosyasının INF dosyasıyla aynı konumda olduğunu varsayar.

İşletim sistemi, sistem tarafından sağlanan tüm xxx.cat dosyalarında böyle bir INF için imzayı doğruladığı için, sistem tarafından sağlanan INF dosyalarında hiçbir zaman CatalogFile= girdisi olmaz.

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

ile başka bir INF yazıcısı tarafından belirlenen benzersiz dosya adını belirtir. katalog dosyasının cat uzantısı. Bu isteğe bağlı girdiler atlanırsa, WDM cihaz/sürücü yüklemelerini doğrulamak için belirli bir CatalogFile=filename.cat kullanılır.

Herhangi bir düzenlenmiş CatalogFile varsa.xxx= girdisi INF'nin Sürüm bölümünde, dekorasyonu yapılmamış catalogfile= girdisiyle birlikte bulunur; cihaz yüklemelerini, sürücü yüklemelerini veya her ikisini de süslü girdinin belirtilmemiş olduğu platformlarda doğrulamaya yönelik bir filename.cat tanımlamak için, kaydedilmemiş girdi varsayılır.

CatalogFile= ve CatalogFile içeren herhangi bir platformlar arası cihaz sürücüsü INF dosyası.xxx= girdileri, bu tür her bir .cat dosyası için benzersiz bir IHV/OEM tarafından belirlenen ad sağlamalıdır.

Sistem tanımlı .nt, .ntx86, .ntia64, .ntamd64, .ntarm ve .ntarm64 uzantılarını kullanma hakkında daha fazla bilgi için bkz. Birden Çok Platform ve İşletim Sistemi için INF Dosyaları Oluşturma.

Note

Aynı .cat dosyası desteklenen tüm platformlarda kullanılabildiğinden, bu girdinin kullanılması gerekli değildir veya önerilmez. Ancak, sürücü paketiniz için platforma özgü .cat dosyaları oluşturmak istiyorsanız bu girdiyi kullanmanız gerekir.

DriverVer=mm/dd/yyyy,w.x.y.z
Bu giriş, bu INF dosyası tarafından yüklenen sürücüler için sürüm bilgilerini belirtir. Windows 2000'den itibaren bu giriş gereklidir.

Bu girdiyi belirtme hakkında bilgi için bkz. INF DriverVer Yönergesi.

PnpLockDown=0|1
Tak ve Kullan (PnP) uygulamasının bir sürücü paketinin INF dosyasının belirttiği dosyaları doğrudan değiştirmesini engelleyip engellemediğini belirtir. PnpLockDown yönergesi 1 olarak ayarlanırsa, PnP uygulamaların INF CopyFiles yönergeleri tarafından kopyalanan dosyaları doğrudan değiştirmesini engeller. Aksi takdirde, yönerge bir INF dosyasına dahil değilse veya yönergenin değeri sıfır olarak ayarlanırsa, yönetici ayrıcalıklarına sahip bir uygulama bu dosyaları doğrudan değiştirebilir. Bu şekilde korunan sürücü dosyaları üçüncü taraf korumalı sürücü dosyaları olarak adlandırılır.

PnP sürücü yüklemesinin bütünlüğünü sağlamak için, uygulamalar sürücü paketi INF dosyası tarafından kopyalanan sürücü dosyalarını doğrudan değiştirmemelidir. Uygulamalar, PnP sürücülerini güncelleştirmek için yalnızca Windows tarafından sağlanan cihaz yükleme mekanizmalarını kullanmalıdır.

Windows Vista'den başlayarak, bir uygulamanın sürücü dosyalarını doğrudan değiştirmesini önlemek için bir sürücü paketi PnpLockDown değerini 1 olarak ayarlamalıdır. Ancak, sürücü paketlerini kaldıran bazı mevcut uygulamalar sürücü dosyalarını doğrudan siler. Bu uygulamalarla uyumluluğu korumak için, bu tür sürücü paketi için PnpLockDown yönergesi sıfır olarak ayarlanmalıdır.

Note

Windows'ın Windows Vista ve sonraki sürümlerinde PnP, bir INF dosyasının sürücü yüklemek için PnpLockDown yönergesi içermesini gerektirmese de, Windows'nin gelecekteki bir sürümündeki PnP, PnP sürücü paketleri için INF dosyalarının PnpLockDown yönergesini içermesini gerektirebilir.

DriverPackageDisplayName=%driver-package-description%
Deprecated. Daha önce Sürücü Yükleme Çerçeveleri (DIFx) tarafından kullanılıyordu. DIFx'in kullanımdan kaldırılması hakkında bilgi için bkz. DIFx Yönergeleri.

DriverPackageType=PackageType
Deprecated. Daha önce Sürücü Yükleme Çerçeveleri (DIFx) tarafından kullanılıyordu. DIFx'in kullanımdan kaldırılması hakkında bilgi için bkz. DIFx Yönergeleri.

Remarks

Bir sürücü paketi Microsoft Windows Donanım Kalite Laboratuvarı (WHQL) testini geçtiğinde, WHQL .cat katalog dosyalarını IHV veya OEM'ye döndürür. Her .cat dosyası, sürücü paketi için dijital olarak şifrelenmiş bir imza içerir. IHV veya OEM bu .cat dosyalarını INF Sürümü bölümünde listelemeli ve dosyaları INF dosyasıyla aynı konumda dağıtım medyasında sağlamalıdır. .cat dosyaları sıkıştırılmamış olmalıdır.

Note

INF Sürümü bölümü en az bir CatalogFile veya CatalogFile.ntxxx girdisi içermiyorsa, sürücü imzasız olarak kabul edilir ve DriverVer yönergesinde listelenen tarihler Windows tarafından görüntülenmez.

Daha fazla bilgi için bkz . Sürücü İmzalama.

Examples

Aşağıdaki örnekte basit bir sürücü paketi INF'sinin tipik Sürüm bölümü, ardından bu örnek Sürüm bölümünde belirtilen girdiler tarafından ima edilen gerekli SourceDisksNames ve SourceDisksFiles bölümleri gösterilmektedir:

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

Ayrıca bkz.

DDInstall

SourceDisksNames

SourceDisksFiles

Dizeler