INF AddFilter ディレクティブ
各 AddFilter ディレクティブは、ドライバー サービスのインストールを宣言型フィルターとしてフィルター位置またはレベルに記述します。 この要素は、Windows 10 バージョン 1903 以降でサポートされています。
レジストリ値を使用して、デバイス スタックに追加する上位フィルターまたは下位フィルターの特定の一覧を指定するのではなく、宣言型フィルターはメタデータを使用してフィルターを登録します。 このメタデータは、デバイスの起動時にフィルターの最終的な一覧を生成するために使用されます。 宣言型フィルターは、UpperFilters/LowerFilters レジストリ値を使用する従来のモデルと組み合わせて使用できます。 宣言型フィルター モデルの詳細については、「デバイス フィルター ドライバーの順序付け」を参照してください。
AddFilter ディレクティブは、INF DDInstall 内で使用されます。[フィルター] セクション。
[DDInstall.Filters]
AddFilter=FilterName,[flags],filter-install-section
Entries
FilterName
インストールするイメージの名前を指定します。 この名前は、システムにインストールされているドライバー サービスの名前と完全に一致する必要があります。
flags
フラグは現在使用されていません。指定する場合は 0 にする必要があります。
filter-install-section
フィルターをデバイス スタックに追加する方法に関するメタデータを含む INF ライター定義セクションを参照します。
解説
INF ライターによって作成された各セクション名は、セクション名を定義するための一般的な規則に従う必要があります。 これらの規則の詳細については、「 INF ファイルの一般的な構文規則」を参照してください。
AddFilter ディレクティブは、INF ファイル内の別の場所で名前付き filter-install-section を参照する必要があります。 このような各セクションの形式は次のとおりです。
[filter-install-section]
[FilterLevel = LevelName]
[FilterPosition = Upper / Lower]
Note
各 filter-install-section では、フィルター位置またはフィルター レベルを定義する必要がありますが、両方を定義する必要はありません。 フィルター メタデータの定義の詳細については、デバイス フィルター ドライバー の順序を参照してください
[filter-install-section]: FilterLevel
FilterLevel = {LevelName}
FilterLevel は、デバイスの 基本ドライバー パッケージ によって定義されたフィルター レベルの名前を指定します。 フィルターはそのレベル名に登録され、基本ドライバー パッケージによって提供されるフィルター レベルのメタデータに従って、登録されたフィルターからフィルター 一覧を組み立てることによって、デバイスの起動時にフィルターの最終的な一覧が決定されます。 指定したフィルター レベルが基本ドライバー パッケージのメタデータで定義されていない場合、フィルターはスタックに追加されません。
フィルター レベルのメタデータを定義するプロセスと、最終的なフィルター 一覧のアセンブル方法の詳細については、「デバイス フィルター ドライバーの順序付け」を参照してください。
[filter-install-section]: FilterPosition
FilterPosition = {Upper / Lower}
FilterPosition は、スタック上のフィルターの位置を、上位または下位のフィルターとして指定します。 デバイスの基本ドライバー パッケージでフィルター レベルのメタデータが指定されている場合、FilterPosition を使用すると、指定された上位または下位のデバイス フィルターの既定のフィルター レベルにフィルターが挿入されます。 基本ドライバー パッケージがこのメタデータを提供しない場合、フィルターは実質的に任意の順序で、指定された上位または下位のフィルターに挿入されます。