INF AddInterface 指令

一個或多個 AddInterface 指令可以在 INF DDInstall.Interfaces 區塊中指定。 此指令安裝針對匯出至高階元件(如其他驅動程式或應用程式)的裝置 介面類別 的支援。 指令通常會參考 add-interface-section ,該區段為裝置介面類別的特定實例設定登錄資訊。

[DDInstall.Interfaces]
  
AddInterface={InterfaceClassGUID} [,[reference-string] [,[add-interface-section][,flags]]] 

匯出的裝置介面類別可以是系統定義的裝置介面類別之一,例如由核心串流定義的,或是由 INF InterfaceInstall32 區塊指定的新裝置介面類別。

Entries

InterfaceClassGUID
指定識別裝置介面類別的 GUID 值。 這可以用 {nnnnnnnn-nnnn-nnnn-nnnnnn-nnnn} 的形式的明確 GUID 值表示,或是定義為 INF 檔案 Strings 區段中「{nnnnnnnn--nnnn nnnn-nn-nn}」的 %strkey% token。

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

參考字串
此可選值與指定介面類別的裝置專屬實例相關,可表示為「引號字串」或 INF 字串區段中定義的 %strkey% token。

PnP 函式與濾波器驅動程式通常會省略 INF 檔案中的 AddInterface= 項目中此值。 參考 字串 由 swenum 驅動程式用作佔位符,用於使用多個單一介面類別的多個實例隨需建立的軟體裝置。 相同的 InterfaceClassGUID 值可在 INF 項目中指定,並包含兩個或以上獨特的 參考字串s。 由於 I/O 管理器會在開啟介面實例時,將 參考字串 值作為介面實例名稱的路徑成分傳遞,因此安裝的驅動程式可以在單一裝置中區分同類別的介面實例。

add-interface-section
在 INF 檔案中引用了某個區段的名稱。 此中通常包含 INF AddReg 指令 ,用以設定匯出驅動程式對此 裝置介面類別的登錄表條目。 欲了解更多資訊,請參閱以下 備註 章節。

flags
若指定,該條目必須為零。

Remarks

如果指定的 {InterfaceClassGUID} 所識別的裝置介面類別尚未安裝,系統設定程式碼會將該類別安裝到系統中。 任何安裝新類別的 INF 檔案也可能包含 INF InterfaceInstall32 區段。 本節包含指定的 {InterfaceClassGUID} ,並參考一個介面 安裝區段 ,該區段為該類別設定介面專屬的安裝操作。

為了讓裝置介面類別的實例讓高階元件在執行時使用,裝置驅動程式必須先呼叫 IoRegisterDeviceInterface ,取得該裝置介面實例的符號連結名稱以啟用。 通常,PnP 函式或過濾器驅動程式會從其 AddDevice 例程中呼叫此呼叫。 為了啟用 INF 中配置的裝置介面實例,裝置驅動程式在呼叫 IoRegisterDeviceInterface 時,必須提供 INF 中指定的 {InterfaceClassGUID} 與參考字串。 驅動程式接著呼叫 IoSetDeviceInterfaceState 以啟用 IoRegisterDeviceInterface 回傳的符號連結名稱來啟用介面。

INF DDInstall.Interfaces 區塊中的每個 AddInterface 指令,都可以參考 INF 檔案中其他由 INF writer 定義的 add-interface-區段。 每個由 INF 撰寫者定義的區名必須在 INF 檔案中唯一,且必須遵循定義區名的一般規則。 欲了解更多規則資訊,請參閱 INF 檔案的一般語法規則。

由 AddInterface 指令參考的 add-interface-section 形式如下:

[add-interface-section]
 
AddReg=add-registry-section[, add-registry-section]...
[AddProperty=add-property-section[, add-property-section] ...]  (Windows Vista and later versions of Windows)
[DelReg=del-registry-section[, del-registry-section] ...]
[DelProperty=del-property-section[, del-property-section] ...]  (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section] ...]
[CopyFiles=@filename | file-list-section[,file-list-section]...]
[DelFiles=file-list-section[,file-list-section]...]
[RenFiles=file-list-section[,file-list-section]...]
[UpdateInis=update-ini-section[, update-ini-section] ...]
[UpdateIniFields=update-inifields-section[, update-inifields-section] ...]
[Ini2Reg=ini-to-registry-section[, ini-to-registry-section] ...]

從 Windows Vista 開始,你可以在新增介面區塊中加入 INF AddProperty 指令來設定裝置介面屬性。 你也可以在新增介面區塊中加入 INF DelProperty 指令來刪除裝置介面屬性。 不過,您應該只使用 AddProperty 或 DelProperty 指令來修改 Windows Vista 或更新版本 Windows 作業系統的新裝置介面屬性。 對於在 Windows Server 2003、Windows XP 或 Windows 2000 引入且有對應登錄檔值的裝置介面屬性,你應該繼續使用 INF AddReg 指令和 INF DelReg 指令來設定和刪除裝置介面屬性。 這些指引適用於系統定義屬性與自訂屬性。 欲了解更多如何使用 AddProperty 指令與 DelProperty 指令,請參閱 使用 INF AddProperty 指令及 INF DelProperty 指令。

通常, add-interface-section 只包含一個 INF AddReg 指令 ,該指令又參考單一 的 add-registry-section。 新增登錄區段用於在登錄檔中儲存裝置驅動程式支援的介面資訊,供更高層級的驅動程式與應用程式後續使用。

在新增介面區段中引用的新增登錄區段,是針對裝置、驅動程式和介面的實例特定。 它可能有一個值項,為匯出的裝置介面實例定義友善名稱,讓更高層的元件能在使用者介面中以友善名稱來稱呼該介面。

在此類新增登錄區段中指定的 HKR 指定裝置介面的執行時可存取狀態登錄金鑰。 驅動程式可在執行時呼叫 IoOpenDeviceInterfaceRegistryKey 以取得狀態登錄鍵的 HANDLE 來存取儲存在該登錄表鍵中的狀態。 使用者模式元件可透過呼叫 CM_Open_Device_Interface_Key 來查詢狀態。

Examples

此範例展示了 DDInstall部分擴展。介面區塊 ,適用於支援系統定義核心串流介面的特定音訊裝置。

; ...
[ESS6881.Device.Interfaces]
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_Wave%,ESSAud.Interface.Wave
AddInterface=%KSCATEGORY_RENDER%,%KSNAME_Wave%,ESSAud.Interface.Wave
AddInterface=%KSCATEGORY_CAPTURE%,%KSNAME_Wave%,ESSAud.Interface.Wave
AddInterface=%KSCATEGORY_AUDIO%,%KSNAME_UART%,WDM.Interface.UART
AddInterface=%KSCATEGORY_RENDER%,%KSNAME_UART%,WDM.Interface.UART
AddInterface=%KSCATEGORY_CAPTURE%,%KSNAME_UART%,WDM.Interface.UART

[ESSAud.Interface.Wave]
AddReg=ESSAud.Interface.Wave.AddReg

[ESSAud.Interface.Wave.AddReg]
HKR,,CLSID,,%Proxy.CLSID%
HKR,,FriendlyName,,%ESSAud.Wave.szPname%
; ... 
[WDM.Interface.UART]
AddReg=WDM.Interface.UART.AddReg

[WDM.Interface.UART.AddReg]
HKR,,CLSID,,%Proxy.CLSID%
HKR,,FriendlyName,,%WDM.UART.szPname%
; ...
[Strings]
KSCATEGORY_AUDIO="{6994ad04-93ef-11d0-a3cc-00a0c9223196}"
KSCATEGORY_RENDER="{65e8773e-8f56-11d0-a3b9-00a0c9223196}"
KSCATEGORY_CAPTURE="{65e8773d-8f56-11d0-a3b9-00a0c9223196}"
; ...
KSNAME_WAVE="Wave"
KSNAME_UART="UART"
; ...
Proxy.CLSID="{17cca71b-ecd7-11d0-b908-00a0c9223196}"
; ... 
ESSAud.Wave.szPname="ESS AudioDrive" 
; ... 

也請參閱

AddProperty

AddReg

BitReg

複製檔案

DDInstall。介面

德爾檔案

德爾邦特

DelReg

Ini2Reg

InterfaceInstall32

IoRegisterDeviceInterface

IoSetDeviceInterfaceState

RenFiles

更新IniFields

更新Inis