共用方式為


INF AddFilter 指示詞

每個 AddFilter 指示詞將驅動程式服務安裝描述為宣告式篩選到篩選位置或層級。 Windows 10 1903 版和更新版本支援此指示詞。

宣告式篩選條件會使用元數據來註冊篩選,而不是使用登錄值來指定要新增至裝置堆疊的特定上下篩選清單。 此元數據可用來在裝置啟動時產生篩選的最終清單。 宣告式篩選可以搭配使用 UpperFilters/LowerFilters 登錄值的舊版模型使用。 如需宣告式篩選模型的詳細資訊,請參閱 裝置篩選驅動程式排序

AddFilter 指示詞會在 INF DDInstall使用。[篩選] 區段。

[DDInstall.Filters]
AddFilter=FilterName,[flags],filter-install-section

項目

FilterName

指定要安裝的篩選名稱。 此名稱必須完全符合安裝在系統上的驅動程式服務名稱。

flags

旗標目前未使用,如果指定,則必須是 0。

filter-install-section

參考 INF 寫入器定義的區段,其中包含應如何將篩選新增至裝置堆疊的元數據。

備註

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

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

[filter-install-section]

[FilterLevel = LevelName]
[FilterPosition = Upper / Lower]

注意

在每個 filter-install-section 中,必須定義篩選位置或篩選層級,但不能同時定義兩者。 如需定義篩選元數據的完整詳細數據,請參閱裝置篩選驅動程式排序

[filter-install-section]: FilterLevel

FilterLevel = {LevelName}

FilterLevel 會指定裝置基底驅動程式套件定義的篩選層級名稱。 篩選條件會使用該層級名稱進行註冊,而當裝置根據基底驅動程式套件所提供的篩選層級元數據,從已註冊的篩選條件組合篩選列表開始時,就會決定篩選條件的最終清單。 如果基底驅動程式套件的元數據中未定義指定的篩選層級,就不會將篩選新增至堆疊。

如需定義篩選層級元數據及最終篩選清單組合方式的完整詳細數據,請參閱 裝置篩選驅動程式排序

[filter-install-section]: FilterPosition

FilterPosition = {Upper / Lower}

FilterPosition 會指定篩選在堆棧上的位置,做為上層或下層篩選條件。 如果裝置的基底驅動程式套件指定篩選層級元數據,使用 FilterPosition 會將篩選插入上層或下層裝置篩選的預設篩選層級,如指定。 如果基底驅動程式套件未提供此元數據,則會以有效任意順序將篩選插入指定的上下篩選。

另請參閱

裝置篩選驅動程式排序