INF AddFilter-Direktive

  • Artikel

Jede AddFilter-Direktive beschreibt die Installation eines Treiberdiensts als deklarativen Filter an einer Filterposition oder -ebene. Diese Direktive wird in Windows 10 Version 1903 und höher unterstützt.

Anstatt einen Registrierungswert zu verwenden, um eine bestimmte Liste von oberen oder unteren Filtern anzugeben, die dem Gerätestapel hinzugefügt werden sollen, registrieren deklarative Filter Filter mithilfe von Metadaten. Diese Metadaten werden verwendet, um die endgültige Liste der Filter zum Zeitpunkt des Gerätestarts zu generieren. Deklarative Filter können in Verbindung mit dem Legacymodell der Verwendung der Registrierungswerte UpperFilters/LowerFilters verwendet werden. Weitere Informationen zum deklarativen Filtermodell finden Sie unter Gerätefiltertreiberbestellung.

Eine AddFilter-Direktive wird in einem INF DDInstall verwendet. Abschnitt "Filter ".

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

Einträge

FilterName

Gibt den Namen des zu installierenden Filters an. Dieser Name muss genau mit dem Namen eines Treiberdiensts übereinstimmen, der auf dem System installiert ist.

flags

Flags sind derzeit nicht verwendet und müssen bei Angabe 0 sein.

filter-install-section

Verweist auf einen inF-Writer definierten Abschnitt, der Metadaten darüber enthält, wie der Filter dem Gerätestapel hinzugefügt werden soll.

Bemerkungen

Jeder vom INF-Writer erstellte Abschnittsname muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Eine AddFilter-Direktive muss an anderer Stelle in der INF-Datei auf einen benannten filter-install-section verweisen. Jeder dieser Abschnitte hat die folgende Form:

[filter-install-section]

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

Hinweis

In jedem abschnitt filter-install-section muss entweder die Filterposition oder die Filterebene definiert werden, aber nicht beides. Ausführliche Informationen zum Definieren von Filtermetadaten finden Sie unter Gerätefiltertreiberreihenfolge .

[filter-install-section]: FilterLevel

FilterLevel = {LevelName}

FilterLevel gibt den Namen einer Filterebene an, die durch das Basistreiberpaket des Geräts definiert wird. Der Filter wird mit dem Namen dieser Ebene registriert, und die endgültige Liste der Filter wird bestimmt, wenn das Gerät gestartet wird, indem die Filterliste aus den registrierten Filtern gemäß den Vom Basistreiberpaket bereitgestellten Metadaten der Filterebene zusammengestellt wird. Falls die angegebene Filterebene nicht in den Metadaten des Basistreiberpakets definiert ist, wird der Filter nicht dem Stapel hinzugefügt.

Ausführliche Informationen zum Definieren der Metadaten auf Filterebene und zur Zusammenstellung der endgültigen Filterliste finden Sie unter Gerätefiltertreiberreihenfolge.

[filter-install-section]: FilterPosition

FilterPosition = {Upper / Lower}

FilterPosition gibt die Position eines Filters im Stapel an, entweder als oberer oder unterer Filter. Wenn das Basistreiberpaket des Geräts Metadaten auf Filterebene angibt, fügt FilterPosition den Filter wie angegeben in die Standardfilterebene für die oberen oder unteren Gerätefilter ein. Wenn das Basistreiberpaket diese Metadaten nicht bereitstellt, wird der Filter in praktisch beliebiger Reihenfolge in die angegebenen oberen oder unteren Filter eingefügt.

Weitere Informationen

Gerätefiltertreiberreihenfolge