Dyrektywa INF AddFilter

Każda dyrektywa AddFilter opisuje instalację usługi sterownika jako filtr deklaratywny do pozycji filtru lub poziomu. Ta dyrektywa jest obsługiwana w systemie Windows 10 w wersji 1903 lub nowszej.

Zamiast używać wartości rejestru, aby określić określoną listę wyższej lub dolnej listy filtrów do dodania do stosu urządzenia, filtry deklaratywne rejestrują filtry przy użyciu metadanych. Te metadane służą do generowania ostatecznej listy filtrów w momencie uruchomienia urządzenia. Filtry deklaratywne mogą być używane w połączeniu ze starszym modelem używania wartości rejestru UpperFilters/LowerFilters. Aby uzyskać więcej informacji na temat modelu filtru deklaratywnego, zobacz Porządkowanie sterowników filtru urządzeń.

Dyrektywa AddFilter jest używana w INF DDInstall. Filtry sekcji.

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

Wpisy

FilterName

Określa nazwę filtru do zainstalowania. Ta nazwa musi być dokładnie zgodna z nazwą usługi sterowników zainstalowanej w systemie.

flagi

Flagi są obecnie nieużywane i muszą być 0, jeśli określono.

filter-install-section

Odwołuje się do sekcji zdefiniowanej przez moduł zapisywania INF, która zawiera metadane dotyczące sposobu dodawania filtru do stosu urządzenia.

Uwagi

Każda nazwa sekcji utworzonej przez moduł zapisywania INF musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz ogólne reguły składni dla plików INF.

Dyrektywa AddFilter musi odwoływać się do nazwanej filter-install-section gdzie indziej w pliku INF. Każda taka sekcja ma następującą formę:

[filter-install-section]

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

[filter-install-section]: FilterLevel

FilterLevel = {LevelName}

FilterLevel określa nazwę poziomu filtru zdefiniowanego przez podstawowy pakiet sterowników urządzenia. Filtr jest rejestrowany przy użyciu tej nazwy poziomu, a ostateczna lista filtrów jest określana, gdy urządzenie rozpoczyna się od zebrania listy filtrów z zarejestrowanych filtrów zgodnie z metadanymi poziomu filtru dostarczonymi przez pakiet sterowników podstawowych. W przypadku, gdy określony poziom filtru nie jest zdefiniowany w metadanych pakietu sterowników podstawowych, filtr nie jest dodawany do stosu.

Aby uzyskać szczegółowe informacje na temat procesu definiowania metadanych na poziomie filtru i sposobu instalowania ostatecznej listy filtrów, zobacz porządkowanie sterowników filtrów urządzeń.

[filter-install-section]: FilterPosition

FilterPosition = {Upper / Lower}

FilterPosition określa położenie filtru na stosie jako górny lub dolny filtr. Jeśli podstawowy pakiet sterowników urządzenia określa metadane na poziomie filtru, użycie FilterPosition spowoduje wstawienie filtru do domyślnego poziomu filtru dla filtrów górnego lub dolnego urządzenia, jak określono. Jeśli podstawowy pakiet sterowników nie dostarcza tych metadanych, filtr zostanie wstawiony do określonych górnych lub niższych filtrów w skutecznie dowolnej kolejności.

Zobacz też

Porządkowanie sterowników filtru urządzeń