INF DDInstall.Interfaces 區段

每位型號,DDInstall_。介面 區塊可以有一個或多個 AddInterface 指令,視該裝置/驅動程式支援的裝置介面數量而定。

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

為了支援現有的裝置介面,例如系統預設的任何核心串流介面,請在本節指定適當的 InterfaceClassGUID 值。

若要安裝一個元件,例如類別驅動程式,匯出一類新的裝置介面,INF 也必須包含 INF InterfaceInstall32 區段。

欲了解更多關於裝置介面的資訊,請參閱 裝置介面類別。

Entries

AddInterface={InterfaceClassGUID} [,[參考字串] [,[add-interface-section] [,,flags_]]]...
此指令安裝對裝置介面類別的支援,該類別由驅動程式輸出至更高階元件的指定 InterfaceClassGUID 值指定。 通常,它也會在 INF 檔案的其他地方參考由 INF 寫入者定義的 add-interface-區段 。 關於如何指定此指令的詳細資訊,請參閱 INF AddInterface 指令。

Include=,檔名。inf[,檔案名稱2.inf]...
此選用條目指定一個或多個系統提供的 INF 檔案,包含登錄該裝置/驅動程式支援介面類別所需的區段。 如果此條目有指定,通常也會標示 為需求 條目。

需求=,inf-section-name[,inf-section-name]...
此選用條目指定安裝此裝置時必須處理的特定區段。 通常,這樣的命名區段是 ,DDInstall_。 系統提供的 INF 檔案中, 包含條目 中的介面區段。 然而,它可以是任何在此類 ,DDInstall_ 中被引用的段落。 包含的INF介面部分。

Remarks

DDInstall 區段名稱必須在 INF 檔案的「各廠商型號」區塊中,以裝置/型號專屬條目引用。 關於如何在跨平台 INF 檔案中使用系統定義的 .nt、.ntx86、.ntia64、.ntamd64、.ntarm 及 .ntarm64 副檔名的資訊,請參閱「為多個平台與作業系統建立 INF 檔案」。

如果指定的 {,InterfaceClassGUID_} 尚未安裝,作業系統的設定程式碼會將該裝置介面類別安裝到系統中。 如果 INF 檔案安裝了一個或多個新的裝置介面類別,也可以有一個 [InterfaceInstall32] 區段來識別該新類別的 GUID。

欲了解更多如何建立 GUID,請參閱 「在驅動程式中使用 GUID」。 關於系統定義的介面類別 GUID,請參閱適當的系統標頭,例如 Ks.h 作為核心串流介面類別 GUIDS。

當驅動程式被載入時,必須呼叫 IoRegisterDeviceInterface 並使用與 AddInterface 指令相同的 {,InterfaceClassGUID_} 及參考字串,才能取得該裝置介面的完整 SymbolicLinkName。 它必須針對 INF 的每個裝置介面,DDInstall_ 來做這件事。介面區段 ,驅動程式在底層裝置上支援。 對於每個 SymbolicLinkName,驅動程式必須呼叫 IoSetDeviceInterfaceState 來啟用該裝置介面。 通常,PnP 函式或過濾器驅動程式會從其 AddDevice 例程中呼叫這些呼叫。

Examples

這個例子展示了 DDInstall。NT。 系統提供的 WDM 音訊裝置/驅動程式 INF 檔案中的介面區段。

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

也請參閱

新增介面

DDInstall

InterfaceInstall32

IoRegisterDeviceInterface

IoSetDeviceInterfaceState

型號