INF DDInstall.Interfaces Bölümü

Her model, DDInstall_. Arabirimler bölümü, belirli bir cihazın/sürücünün desteklediği cihaz arabiriminin kaç tanesine bağlı olarak bir veya daha fazla AddInterface yönergesine sahip olabilir.

[install-section-name.Interfaces] |
[install-section-name.nt.Interfaces] | 
[install-section-name.ntx86.Interfaces] |
[install-section-name.ntia64.Interfaces] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.Interfaces] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.Interfaces] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.Interfaces] (Windows 10 version 1709 and later versions of Windows)
 
AddInterface={InterfaceClassGUID} [, [reference string] [,[add-interface-section] [,flags]]] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...] 

Sistemin önceden tanımlanmış çekirdek akışı arabirimlerinden herhangi biri gibi mevcut cihaz arabirimlerini desteklemek için bu bölümde uygun InterfaceClassGUID değerlerini belirtin.

Yeni bir cihaz arabirim sınıfını dışarı aktaran bir sınıf sürücüsü gibi bir bileşeni yüklemek için, INF'nin bir INF ArabirimiInstall32 bölümüne de sahip olması gerekir.

Cihaz arabirimleri hakkında daha fazla bilgi için bkz. Cihaz Arabirimi Sınıfları.

Giriş

AddInterface={InterfaceClassGUID} [,[başvuru dizesi] [,[add-interface-section] [,,flags_]]]...
Bu yönerge, sürücünün daha üst düzey bileşenlere dışarı aktardığı belirtilen InterfaceClassGUID değeri tarafından belirlenen bir cihaz arabirimi sınıfı desteğini yükler. Genellikle, INF dosyasının başka bir yerindeki INF yazıcı tanımlı add-interface-bölümüne de başvurur. Bu yönergeyi belirtme hakkında ayrıntılı bilgi için bkz. INF AddInterface Yönergesi.

Include=,filename. inf[,dosyaadı2.inf]...
Bu isteğe bağlı girdi, bu cihaz/sürücü tarafından desteklenen arabirim sınıflarını kaydetmek 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 bir Needs girdisi de belirtilir.

Needs=,inf-section-name[,inf-section-name]...
Bu isteğe bağlı girdi, bu cihazın yüklenmesi sırasında işlenmesi gereken belirli bölümleri belirtir. Genellikle, böyle adlandırılmış bir bölüm bir ,DDInstall_. Ekleme girdisinde listelenen, sistem tarafından sağlanan bir INF dosyasındaki arabirimler bölümü. Ancak, bu tür bir ,DDInstall_ içinde başvuruda bulunılan herhangi bir bölüm olabilir. Dahil edilen INF'nin Arabirimler bölümü.

Remarks

DDInstall bölüm adına, INF dosyasının üretici başına Modeller bölümünde cihaza/modellere özgü bir girdi tarafından başvurulmalıdır. Platformlar arası INF dosyalarında sistem tanımlı .nt, .ntx86, .ntia64, .ntamd64, .ntarm ve .ntarm64 uzantılarını kullanma hakkında bilgi için bkz. Birden Çok Platform ve İşletim Sistemi için INF Dosyaları Oluşturma.

Belirtilen bir {,InterfaceClassGUID_} zaten yüklü değilse, işletim sisteminin kurulum kodu bu cihaz arabirimi sınıfını sisteme yükler. BIR INF dosyası bir veya daha fazla yeni cihaz arabirimi sınıfı yüklerse, yeni sınıfın GUID'sini tanımlayan [ InterfaceInstall32] bölümüne de sahip olabilir.

GUID oluşturma hakkında daha fazla bilgi için bkz. Sürücülerdeki GUID'leri kullanma. Sistem tanımlı arabirim sınıfı GUID'leri için, çekirdek akış arabirim sınıfı GUID'leri için Ks.h gibi sistem tarafından sağlanan uygun üst bilgisine bakın.

Bir sürücü yüklendiğinde, cihaz arabiriminin tam SymbolicLinkName değerini almak için IoRegisterDeviceInterface'i aynı {,InterfaceClassGUID_} ile çağırması ve AddInterface yönergesinde kullanılan başvuru dizesini çağırması gerekir. BUNU INF'nin ,DDInstall_ her cihaz arabirimi için yapmalıdır. Sürücünün temel alınan cihazda desteklediği arabirimler bölümü. Her SymbolicLinkName için, cihaz arabirimini etkinleştirmek için sürücünün IoSetDeviceInterfaceState çağrısı yapması gerekir. Genellikle, bir PnP işlevi veya filtre sürücüsü bu çağrıları AddDevice yordamından yapar.

Examples

Bu örnekte DDInstall gösterilmektedir. nt. Sistem tarafından sağlanan WDM ses cihazı/sürücüsü için INF dosyasındaki Arabirimler bölümü.

;
; following AddInterface= are all single lines (without 
; backslash line continuators) in the system-supplied INF file
;
[WDMPNPB003_Device.NT.Interfaces]
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_Wave%,\
  WDM_SB16.Interface.Wave
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_Topology%,\
  WDM_SB16.Interface.Topology
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_UART%,\
  WDM_SB16.Interface.UART
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_FMSynth%,\
  WDM_SB16.Interface.FMSynth
; ...

[Strings] ; only immediately preceding %strkey% tokens shown here
%KSCATEGORY_AUDIO% = "{6994ad04-93ef-11d0-a3cc-00a0c9223196}"
KSNAME_Wave = "Wave"
KSNAME_UART = "UART"
KSNAME_FMSynth = "FMSynth" 
KSNAME_Topology = "Topology"
; ...

Ayrıca bkz.

AddInterface

DDInstall

InterfaceInstall32

IoRegisterDeviceInterface

IoSetDeviceInterfaceState

Modeller