共用方式為


INF DDInstall.COM 區段

每個模型 DDInstall.COM 區段都包含一或多個 INF AddComServer 指示詞,這些指示詞 會參考 INF 檔案中的其他 INF 寫入器定義區段。 Windows 11 版本 24H2 和更新版本支援本節。

[install-section-name.COM] |
[install-section-name.nt.COM] |
[install-section-name.ntamd64.COM] |
[install-section-name.ntarm64.COM]

AddComServer = com-server-name, [flags], com-server-install-section
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]

註冊 COM 伺服器至少需要一個 AddComServer 指示詞。

項目

AddComServer=com-server-name,flags,com-server-install-section

AddComServer 指示詞會參考 INF 檔案中其他地方的 INF 寫入器定義 com-server-install-section。 AddComServer 指示詞可用來註冊多個 COM 伺服器一或多次。 如需詳細資訊, 請參閱 INF AddComServer 指示詞 和一般 COM 伺服器的指示詞,請參閱 COM 用戶端和伺服器

Include=filename.inf[,filename2.inf]...

這個選擇性專案會指定一或多個其他系統提供的 INF 檔案,其中包含安裝此裝置所需的區段。 如果指定此專案, 也需要 [需要 ] 專案。

Needs=inf-section-name[,inf-section-name]...

這個選擇性專案會指定在安裝此裝置期間必須處理的區段。 一般而言,區段是系統提供的 INF 檔案內的 DDInstall.COM 區段,列在 Include 專案中。 不過,它可以是 DDInstall.COM 區段中參考的任何區段。

備註

COM 二進位檔會使用 DDInstall 區段中的 CopyFiles 指示詞就地安裝到位。 二進位檔應該安裝到相對於驅動程式套件的 驅動程式存放區路徑 的位置(例如 DIRID 13)。 同樣地,裝置安裝會在裝置相對登錄位置下寫入 COM 註冊。

客戶端必須在背景工作線程上呼叫 CoRegisterDeviceCatalog,才能呼叫 CoCreateInstance。 呼叫 CoRegisterDeviceCatalog 可讓 COM 運行時間在程式中使用 COM 伺服器註冊。

DDInstall.COM 區段應該具有與其相關 DDInstall 區段相同的平臺和操作系統裝飾。 例如,install-section-name.ntamd64 區段會有對應的 install-section-name.ntamd64.COM 區段。 指定的 DDInstall 區段必須參考 INF 檔案中每個製造商型號區段下的裝置/型號特定專案。 正式語法語句中顯示的install-section-name 不區分大小寫的延伸模組可以插入跨平臺 INF 檔案中的這類 DDInstall.COM 區段名稱中。

如需如何使用系統定義的 .nt、.ntamd64.ntarm64 延伸模組的詳細資訊,請參閱建立多個平臺和操作系統的 INF 檔案。

範例

[Device_Install.COM]
AddComServer   = VendorComServer,, VendorComServer_Inst

[VendorComServer_Inst]
ServerType     = 1 ; in-proc
ServerBinary   = %13%\Vendor_ComServer.dll
AddComClass    = {bb2b85ab-9473-42e5-8d1a-0f01d3879879},, Vendor_ComClass_Inst

[Vendor_ComClass_Inst]
Description    = %Vendor_ComClass_Desc%
ThreadingModel = Neutral

[Strings]
%Vendor_ComClass_Desc%="Vendor Com Server"

另請參閱