INF-AddFilter-Anweisung
Jede AddFilter-Anweisung beschreibt die Installation eines Treiberdiensts als deklarativen Filter in einer Filterposition oder -ebene. Diese Anweisung wird ab Windows 10, Version 1903 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 zu dem Zeitpunkt zu generieren, zu dem das Gerät gestartet wird. Deklarative Filter können zusammen mit dem veralteten Modell der Verwendung der UpperFilters/LowerFilters-Registrierungswerte verwendet werden. Weitere Informationen zum deklarativen Filtermodell finden Sie unter Sortierung des Gerätefiltertreibers.
Eine AddFilter-Anweisung wird in einem INF DDInstall.Filters-Abschnitt verwendet.
[DDInstall.Filters]
AddFilter=FilterName,[flags],filter-install-section
Entries
FilterName
Gibt den Namen des zu installierenden Filters an. Dieser Name muss exakt mit dem Namen eines Treiberdiensts übereinstimmen, der auf dem System installiert ist.
flags
Flags werden zurzeit nicht verwendet und müssen 0 sein, falls angegeben.
filter-install-section
Verweist auf einen INF-Writer-defined-Abschnitt, der Metadaten darüber enthält, wie der Filter dem Gerätestapel hinzugefügt werden soll.
Hinweise
Jeder INF-writer-created 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-Anweisung muss auf einen benannten filter-install-section an anderer Stelle in der INF-verweisen. Jeder dieser Abschnitte hat die folgende Form:
[filter-install-section]
[FilterLevel = LevelName]
[FilterPosition = Upper / Lower]
Hinweis
In jedem filter-install-section muss entweder die Filterposition oder die Filterebene definiert werden, aber nicht beide. Ausführliche Informationen zum Definieren von Filtermetadaten finden Sie unter Sortierung der Gerätefiltertreiber
[filter-install-section]: FilterLevel
FilterLevel = {LevelName}
FilterLevel gibt den Namen einer Filterebene an, die vom Basistreiberpaket des Geräts definiert wird. Der Filter wird mit diesem Ebenennamen registriert und die endgültige Liste der Filter wird beim Start des Geräts durch Zusammenstellen der Filterliste aus den registrierten Filtern in Übereinstimmung mit den vom Basistreiberpaket bereitgestellten Filterebenen-Metadaten festgelegt. Wenn die angegebene Filterebene nicht in den Metadaten des Basistreiberpakets definiert ist, wird der Filter nicht zum Stapel hinzugefügt.
Ausführliche Informationen zum Definieren der Metadaten auf Filterebene und zur Zusammenstellung der endgültigen Filterliste finden Sie unter Sortierung der Gerätefiltertreiber.
[filter-install-section]: FilterPosition
FilterPosition = {Upper / Lower}
FilterPosition gibt die Position eines Filters im Stapel als oberer oder niedrigerer Filter an. Wenn das Basistreiberpaket des Geräts Metadaten auf Filterebene angibt, fügt die Verwendung von FilterPosition den Filter wie angegeben in die Standardfilterebene für die Filter der oberen oder unteren Geräte ein. Wenn das Basistreiberpaket diese Metadaten nicht liefert, wird der Filter in die angegebenen oberen oder unteren Filter in effektiv beliebiger Reihenfolge eingefügt.