INF InterfaceInstall32 區段

發行項
02/02/2024

本節會建立一或多個新的裝置介面類別。建立新的類別之後，後續安裝的裝置/驅動程式可以藉由呼叫 IoRegisterDeviceInterface來註冊新裝置介面類別的支援。

[InterfaceInstall32]
 
{InterfaceClassGUID}=install-interface-section[,flags]
...

項目

InterfaceClassGUID
指定 GUID 值，識別新匯出的裝置介面類別。

若要註冊介面類別的實例，裝置的驅動程序必須使用此 GUID 呼叫 IoRegisterDeviceInterface 。本節中指定的 GUID 值也可以由 INFDDInstall 中的 INF AddInterface 指示詞參考。介面區段。

如需如何建立 GUID 的詳細資訊，請參閱在驅動程式中使用 GUID。如需系統定義的介面類別 GUIDS，請參閱適當的標頭，例如核心串流介面的 Ks.h 。

install-interface-section
參考 INF 寫入器定義的區段，可能具有這個 INF 中任何系統定義的延伸模組。

flags
如果指定，此項目必須是零。

備註

當系統中尚未安裝指定的 InterfaceClassGUID 時，該介面類別會安裝為對應的 DDInstall。介面 區段會在裝置安裝期間處理，或當該裝置的驅動程式對 IoRegisterDeviceInterface 進行初始呼叫時。

每個 install-interface-section 名稱在 INF 檔案內必須是唯一的，而且必須遵循定義區段名稱的一般規則。如需這些規則的詳細資訊，請參閱 INF 檔案的一般語法規則。

任何指定的 install-interface-section 都有下列一般形式：

[interface-install-section] | 
[interface-install-section.nt] | 
[interface-install-section.ntx86] | 
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 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)
[Copyfiles=@filename | 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)
[BitReg=bit-registry-section[,bit-registry-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]...]
...

如需 interface-install-section 中專案的詳細資訊，請參閱 INF DDInstall 區段。

從 Windows Vista 開始，您可以在 interface-install 區段中加入 INF AddProperty 指示詞來設定裝置介面類別屬性。您也可以在 interface-install 區段中加入 INF DelProperty 指示 詞，以刪除裝置介面類別屬性。不過，您應該只使用 AddProperty 或 DelProperty 指示詞來修改 Windows Vista 或更新版本 Windows 操作系統的裝置介面類別屬性。針對在 Windows Server 2003、Windows XP 或 Windows 2000 上引進的裝置介面類別屬性，而且具有對應的登錄值專案，您應該繼續使用 INF AddReg 指示 詞和 INF DelReg 指示 詞來設定和刪除裝置介面類別屬性。這些指導方針適用於系統定義的屬性和自定義屬性。如需如何使用 AddProperty 指示詞和 DelProperty 指示詞的詳細資訊，請參閱使用 INF AddProperty 指示詞和 INF DelProperty 指示詞。