INF AddComponent 指示詞

AddComponent指示詞用於INF DDInstall中。延伸模組 INF 檔案的元件區段。 它會為目前裝置下的軟體元件建立虛擬子裝置。 Windows 10 1703 版和更新版本支援這個指示詞。

[DDInstall.Components]

AddComponent=ComponentName,[flags],component-install-section

項目

ComponentName

指定要建立的軟體元件名稱。 INF 檔案中的每個 AddComponent 指示詞都必須有唯一的值。

flags

指定一或多個 (ORed) 旗標,目前未定義但保留供日後使用。

component-install-section

參考 INF 寫入器定義的區段,其中包含為此裝置建立具名軟體元件的資訊。

備註

每個 INF 寫入器建立的區段名稱在 INF 檔案內都必須是唯一的,而且必須遵循定義區段名稱的一般規則。 如需這些規則的詳細資訊,請參閱 INF 檔案的一般語法規則

AddComponent指示詞必須參考 INF 檔案中其他位置的具名component-install-section。 每個這類區段都有下列形式:

[component-install-section]

ComponentIDs=component-id[,component-id] …
[Description=description]

每個 component-install-section 至少必須有 ComponentID 專案 ,如下所示。 不過,其餘專案是選擇性專案。

請注意, ComponentIDHardwareID,這表示它們是硬體開發人員所定義的字串。 為了確保這些識別碼的唯一性,在大部分情況下,我們建議遵循 PCI 裝置所使用的識別碼架構。 廠商可能想要使用不同的架構,但視案例而定。

例如,單一裝置上具有多個元件的廠商可能會想要將元件的硬體識別碼與父系產生關聯。 在此情況下,他們可以將四個字元廠商定義的元件識別碼附加至父代的硬體識別碼,以建立 ComponentID

Component-Install區段專案和值

ComponentIDs=id1[, id2] ...[, idN]

指定軟體元件的元件識別碼。 元件識別碼的運作方式與硬體識別碼相同,而且應該遵循 類似的格式。 對於軟體元件,系統會在 前面加上 INF 提供的值 SWC\ ,以建立硬體識別碼。 例如,的 VID0001&PID0001ComponentIDs值會產生 的硬體識別碼 SWC\VID0001&PID0001

描述=描述

選擇性地指定描述軟體元件的字串,通常用於當地語系化,以 INF Strings 區段中定義的 %strkey% 權杖表示。

如果描述字串包含任何 %strkey% 標記,則每個權杖最多可以代表 511 個字元。 任何字串標記替代之後的字串總計不應超過 1024 個字元。

另請參閱

使用元件 INF 檔案

DDInstall元件

INF AddSoftware 指示詞