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 會將篩選插入上層或下層裝置篩選的預設篩選層級,如指定。 如果基底驅動程式套件未提供此元數據,則會以有效任意順序將篩選插入指定的上下篩選。