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

另請參閱

裝置篩選驅動程式排序