Aracılığıyla paylaş


INF DDInstall bölümü

Her model DDInstall bölümü isteğe bağlı DriverVer yönergesini ve burada en sık belirtilen INF yönergeleriyle gösterilen, CopyFiles ve addRegilk listelenen INF dosyasındaki ek adlandırılmış bölümlere başvuran bir veya daha fazla yönerge içerir.

Bu yönergeler tarafından başvuruda bulunılan bölümler, sürücü dosyalarını yüklemeye ve cihaza özgü ve/veya sürücüye özgü bilgileri kayıt defterine yazmaya yönelik yönergeler içerir.

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

Giriş

Evrensel INFtüm geçerli girdiler desteklenmez. Aşağıdaki listede hangi yönergelerin evrensel INF'de geçerli olduğu ve hangilerinin geçerli olmadığı listelenir.

Evrensel INF'de desteklenir

DriverVer=mm/dd/yyyy[,x.y.v.z]
Bu isteğe bağlı girdi,sürücü paketi için sürüm bilgilerini belirtir.

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

CopyFiles=@dosya adı | file-list-section[,file-list-section] ...
Bu yönerge, kaynak medyadan hedefe kopyalanacak bir adlandırılmış dosyayı belirtir veya kaynak medyadaki cihazla ilgili dosyaların hedefe aktarılması için belirtildiği bir veya daha fazla INF yazıcı tanımlı bölüme başvurur. CopyFiles yönergesi isteğe bağlıdır, ancak çoğu DDInstall bölümünde bulunur.

INF'nin DestinationDirs bölümündeki DefaultDestDir girdisi, kopyalanacak tek bir dosyanın hedefini belirtir. SourceDisksNames ve SourceDisksFiles bölümleri veya bu INF'nin Sürüm bölümünün LayoutFile girdisinde belirtilen ek bir INF, sürücü dosyalarının dağıtım medyasında konumu sağlar.

Daha fazla bilgi için bkz. INF CopyFiles Yönergesi.

CopyINF=filename1.inf[,filename2.inf]...
(Windows XP ve üzeri) Bu yönerge, belirtilen INF dosyalarının hedef sisteme kopyalanmasına neden olur.

Daha fazla bilgi için bkz. INF CopyINF Yönergesi.

AddReg=add-registry-section[,add-registry-section]...
Bu yönerge, büyük olasılıkla ilk değer girdilerine sahip yeni alt anahtarların kayıt defterine yazılması veya mevcut anahtarların değer girdilerinin değiştirildiği bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Bu tür bir kayıt defteri ekleme bölümündeki HKR belirtimi, yüklenen cihazın "yazılım anahtarı" kayıt defteri yolunu belirtir.

Daha fazla bilgi için bkz. INF AddReg Yönergesi.

AddProperty=add-property-section[,add-property-section]...
(Windows Vista ve üzeri) Bir cihaz örneği için ayarlanmış cihaz özelliklerini değiştiren bir veya daha fazla INF dosyası bölümüne başvurur. INF AddProperty yönergesi yalnızca Windows Vista veya Windows işletim sistemlerinin sonraki sürümlerinde yeni olan bir cihaz örneği özelliğini ayarlamak için kullanmanız gerekir.

Daha önce Windows Server 2003, Windows XP veya Windows 2000'de tanıtılan ve buna karşılık gelen kayıt defteri giriş değerlerine sahip olan cihaz örneği özellikleri için, cihaz örneği özelliklerini ayarlamak için INF AddReg yönergelerini kullanmaya devam etmelisiniz. Bu yönergeler, sistem tanımlı özellikler ve özel özellikler için geçerlidir. AddProperty yönergesini kullanma hakkında daha fazla bilgi için bkz. INF AddProperty Yönergesini kullanma ve INF DelProperty Yönergesi.

Include=filename1.inf[,filename2.inf]...
Bu isteğe bağlı girdi, bu cihazı ve/veya sürücüyü yüklemek için gereken bölümleri içeren bir veya daha fazla ek sistem tarafından sağlanan INF dosyasını belirtir. Bu girdi belirtilirse, genellikle girişi gerekir.

Örneğin, sistemin çekirdek akışı desteğine bağlı olan cihaz sürücüleri için INF dosyaları şu girdiyi belirtebilir:

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

Needs=inf-section-name[,inf-section-name]...
Bu isteğe bağlı girdi, bu cihazın yüklenmesi sırasında işlenmesi gereken sistem tarafından sağlanan INF dosyalarındaki bölümleri belirtir. Genellikle, bu tür adlandırılmış bir bölüm, ekle girdisinde listelenen INF dosyalarından birinin içindeki DDInstall (veya DDInstall.xxx) bölümüdür. Ancak, bu tür bir DDInstall veya DDInstalliçinde başvuruda bulunabilecek herhangi bir bölüm olabilir. dahil edilen INF'nin xxx bölümünü.

Örneğin, önceki dahil girdisine sahip cihaz sürücüleri için INF dosyaları bu girdiyi aşağıdaki gibi belirtebilir:

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

FeatureScore=featurescore

Uyarı

FeatureScore yönergesi yalnızca doğrudan [DDInstall] bölümünde belirtildiğinde işlenir.

(Windows Vista ve üzeri) Bu yönerge, sürücülerin desteklediği özellikleri temel alan ek bir derecelendirme ölçütü sağlar. Örneğin, sınıfa özgü ölçütlere göre sürücüleri birbirinden ayıran cihaz kurulum sınıfı için özellik puanları tanımlanabilir.

Sürücülerin derecelerinin nasıl olduğu hakkında daha fazla bilgi için bkz. Windows Sürücüleri Nasıl Derecelendiriyor (Windows Vista ve Üzeri).

Bu yönerge hakkında daha fazla bilgi için bkz. INF FeatureScore Yönergesi.

Not

bir DDInstall bölümü birden çok FeatureScore girdisi içerebilir, ancak bölüm için yalnızca ilk girdi işlenir.

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

Uyarı

ExcludeID yönergesi yalnızca doğrudan [DDInstall] bölümünde belirtildiğinde işlenir.

(Windows XP ve üzeri) Bu yönerge bir veya daha fazla cihaz tanımlama dizesini belirtir (donanım kimlikleri veya uyumlu kimlikler). DDInstall bölümü, listelenen donanım kimlikleri veya uyumlu kimliklerle eşleşen cihaz kimliklerine sahip cihazları yüklemez.

yeniden başlatma
Bu yönerge, yükleme tamamlandıktan sonra çağıranın sistemi yeniden başlatması istenmesi gerektiğini gösterir.

Daha fazla bilgi için bkz. INF Yeniden Başlatma Yönergesi.

Evrensel INF'de desteklenmez

Delfiles=file-list-section[,file-list-section]...
Bu yönerge, silinecek hedefte dosyaları listeleyen bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Daha fazla bilgi için bkz. INF DelFiles Yönergesi.

Renfiles=file-list-section[,file-list-section]...
Bu yönerge, cihazla ilgili kaynak dosyalar hedef bilgisayara kopyalanmadan önce hedefte yeniden adlandırılacak dosyaları listeleyen bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Daha fazla bilgi için bkz. INF RenFiles Yönergesi.

DelReg=del-registry-section[,del-registry-section]...
Bu yönerge, cihazların yüklenmesi sırasında anahtarların ve/veya değer girdilerinin kayıt defterinden kaldırılacak şekilde belirtildiği bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Bu yönerge genellikle, bir INF'nin bu cihazın önceki yüklemesinden eski kayıt defteri girdilerini temizlemesi gerektiğinde yükseltmeleri işlemek için kullanılır.

Bu tür bir kayıt defteri silme bölümündeki HKR belirtimi, yüklenen cihazın "yazılım anahtarı" kayıt defteri yolunu belirtir.

Daha fazla bilgi için bkz. INF DelReg Yönergesi.

DelProperty=del-property-section[,del-property-section]...
(Windows Vista ve üzeri) Bir cihaz örneği için ayarlanan cihaz özelliklerini silecek bir veya daha fazla INF dosyası bölümüne başvurur. INF DelProperty yönergesi yalnızca Windows Vista'da veya Windows'un sonraki sürümlerinde yeni olan bir cihaz örneği özelliğini silmek için kullanmanız gerekir.

Windows Server 2003, Windows XP veya Windows 2000'de daha önce tanıtılan ve buna karşılık gelen kayıt defteri giriş değerlerine sahip cihaz örneği özellikleri için, cihaz örneği özelliklerini silmek için INF DelReg yönergelerini kullanmaya devam etmelisiniz. Bu yönergeler, sistem tanımlı özellikler ve özel özellikler için geçerlidir. DelProperty yönergesini kullanma hakkında daha fazla bilgi için bkz. INF AddProperty Yönergesini kullanma ve INF DelProperty Yönergesi.

BitReg=bit-registry-section[,bit-registry-section]...
Bu yönerge, REG_BINARY türündeki mevcut kayıt defteri değeri girdilerinin değiştirildiği bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Böyle bir bit kayıt defteri bölümündeki HKR belirtimi, yüklenen cihazın "yazılım anahtarı" kayıt defteri yolunu belirtir.

Daha fazla bilgi için bkz. INF BitReg Yönergesi.

LogConfig=log-config-section[,log-config-section]...
Bu yönerge, kök numaralandırılmış bir cihaz veya el ile yüklenmiş bir cihaz için INF içinde bir veya daha fazla INF yazıcı tanımlı bölüme başvurur. Bu adlandırılmış bölümlerde, böyle bir "algılanan" veya el ile yüklenen cihaz için INF, cihazın çalışır durumda olması gereken veri yolu göreli donanım kaynaklarının bir veya daha fazla mantıksal yapılandırmasını belirtir. Yazılım tarafından yapılandırılamayan el ile yüklenmiş böyle bir cihazın INF'sinde de DDInstallolmalıdır. FactDef bölümü.

LogConfig yönergesi tak çalıştır (PnP) cihazlarını yüklemek için hiçbir zaman kullanılmaz. Ancak, PnP cihazları için geçersiz kılma yapılandırması sağlamak üzere INF DDInstall.LogConfigOverride bölümü kullanabilirsiniz.

Bu yönerge, tüm üst düzey (nondevice) sürücüler ve bileşenlerle ilgisizdir.

Daha fazla bilgi için bkz. INF LogConfig Yönergesi.

ProfileItems=profile-items-section[,profile-items-section]...
(Windows'un Microsoft Windows 2000 ve sonraki sürümleri) Bu nadiren kullanılan yönerge, Başlat menüsüne eklenecek veya kaldırılacak öğeleri açıklayan bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Daha fazla bilgi için bkz. INF ProfileItems Yönergesi.

UpdateInis=update-ini-section[,update-ini-section]...
Bu nadiren kullanılan yönerge, bir veya daha fazla INF yazıcı tanımlı bölüme başvurur ve bu tür bir bölümdeki belirli bir bölümün veya satırın yükleme sırasında aynı ada sahip bir hedef INI dosyasına okunacağı bir kaynak INI dosyası belirtir. İsteğe bağlı olarak, aynı ada sahip belirli bir kaynak INI dosyasından hedefte var olan bir INI dosyasında yapılan satır satır değişiklikler update-ini bölümünde belirtilebilir.

Daha fazla bilgi için bkz. INF UpdateInis Yönergesi.

UpdateIniFields=update-inifields-section[,update-inifields-section]...
Bu nadiren kullanılan yönerge, cihaza özgü bir INI dosyasının satırlarındaki değişikliklerin belirtildiği bir veya daha fazla INF yazıcı tanımlı bölüme başvurur.

Daha fazla bilgi için bkz. INF UpdateIniFields Yönergesi.

Ini2Reg=ini-registry-section[,ini-to-registry-section]...
Bu nadiren kullanılan yönerge, kaynak medyada sağlanan cihaza özgü bir INI dosyasındaki bölümlerin veya satırların kayıt defterine taşınacağı, INF yazıcı tanımlı bir veya daha fazla bölüme başvurur.

Daha fazla bilgi için bkz. INF Ini2Reg Yönergesi.

RegisterDlls=register-dll-section[,register-dll-section]...
Bu yönerge, OLE denetimleri olan ve kendi kendine kayıt gerektiren dosyaları belirtmek için kullanılan bir veya daha fazla INF bölümüne başvurur.

Daha fazla bilgi için bkz. INF RegisterDlls Yönergesi.

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Bu yönerge, OLE denetimleri olan ve kendi kendine kayıt kaldırma (kendi kendini kaldırma) gerektiren dosyaları belirtmek için kullanılan bir veya daha fazla INF bölümüne başvurur.

Daha fazla bilgi için bkz. INF UnregisterDlls Yönergesi.

Açıklamalar

Windows Sürücü Seti (WDK) belgeleri boyunca, platform uzantıları olan veya olmayaninstall-section-namebaşvurmak için DDInstall terimi kullanılır. Bu nedenle, "DDInstall bölümü", "[install-section-name] ] veya [install-section-name.ntxxx]" biçiminde bir INF içindeki adlandırılmış bölüm anlamına gelir. DDInstall bölümleri için ad oluşturduğunuzda, [WDMPNPB003_Device] veya [GPR400 gibi cihaza özgü bir ön ek eklemeniz gerekir. Install.NT].

Her DDInstall bölümü, INF dosyasının üretici başına INF Modelleri bölümü altındaki cihaza/modellere özgü girişte başvurulmalıdır.

Kaynak medyadan aktarılacak ilişkili dosyası olmayan cihazlar dışında, farklı işletim sistemi platformlarına WDM sürücüsü yükleyen bir INF dosyasının DDInstall bölümlerinden en az biri olmalıdır:

  • x86 tabanlı platformlara özgü cihaz/sürücü yüklemelerinin girdilerini belirten bir install-section-name.ntx86 bölümü.
  • Itanium tabanlı platformlara özgü cihaz/sürücü yüklemelerinin girdilerini belirten bir install-section-name.ntia64 bölümü.
  • x64 tabanlı platformlara özgü cihaz/sürücü yüklemelerinin girdilerini belirten bir install-section-name.ntamd64 bölümü.
  • Arm tabanlı platformlara özgü cihaz/sürücü yüklemelerinin girdilerini belirten bir install-section-name.ntarm bölümü.
  • Arm64 tabanlı platformlara özgü cihaz/sürücü yüklemelerinin girdilerini belirten .ntarm64 bölümübir install-section-name.
  • Belirli bir donanım platformuna özgü olmayan cihaz/sürücü yüklemelerinin girdilerini belirten bir install-section-name veya install-section-name.nt bölümü.

.nt , .ntx86, .ntia64, .ntamd64, .ntarmve .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.

Windows 2000'den başlayarak, sürücüleri yükleyen bir INF dosyasının sürücü hizmeti bilgilerini belirtmek için DDInstall.Services bölümleri olmalıdır.

DDInstall bölümündeki her yönerge birden fazla bölüm adına başvurabilir. Ancak, her ek adlandırılmış bölüm bir sonrakinden virgülle (,) ayrılmalıdır.

Her bölüm adının INF dosyasında benzersiz olması ve bölüm adlarını tanımlamaya yönelik genel kurallara uyması gerekir. Bu kurallar hakkında daha fazla bilgi için bkz. INF Dosyaları için Genel Sözdizimi Kuralları.

DDInstall bölümünde belirtilen herhangi bir AddReg yönergesi, üst veya alt filtre sürücüleri, çok işlevli cihazlar veya sürücüden bağımsız ancak cihaza özgü parametreler hakkında bilgi depolamak için kullanılamayan bir add-registry bölümüne başvuracağı varsayılır. Bir cihaz/sürücü INF'sinin bu tür bilgileri kayıt defterinde depolaması gerekiyorsa, DDInstallsıralanmamış ve düzenlenmiş bir AddReg yönergesi kullanmalıdır. HW, varsa, add-registry-sectionbaşka bir INF yazıcı tanımlı başvurmak için bölümleri.

INF Sürümü bölümünde belirtilen cihaz kurulum sınıfı bağlı olarak, DDInstall bölümünde sınıfa özgü ek yönergeler belirtilebilir. Sınıfa özgü yönergeler hakkında daha fazla bilgi için aşağıdaki konulara bakın:

Örnekler

Bu örnekte DDInstall bölümlerinin Ser_Inst ve Inp_Instgenişletilmesi gösterilmektedir. Bu bölümlere,INF Modelleri bölümü için örnekte başvurulur.

[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

Aşağıdaki örnekte, çeşitli işletim sistemi platformlarında bir ses cihazı için sistem tarafından sağlanan WDM sürücüsünü yükleyen INF dosyasının DDInstall bölümü gösterilmektedir:

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

Aşağıdaki örnekte, sistem tarafından sağlanan ks.inf ve wdmaudio.inf dosyalarında önceki needs girdisi tarafından başvuruda bulunan bölümler gösterilmektedir. Yukarıdaki örnekte, bu dosyalar içerir girdisinde belirtilmiştir. İşletim sisteminin cihaz yükleyicisi bu cihazın install-section-nameişlediğinde. nt bölümü, bu sonraki iki bölüm de işlenir.

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

Ayrıca bkz.

AddProperty

DDInstall. CoInstallers

DDInstall. FactDef

DDInstall. HW

DDInstall. Arabirimler

DDInstall. LogConfigOverride

DDInstall. Hizmetler

DefaultInstall

DefaultInstall.Services

DelProperty

FeatureScore