Diretiva INF AddFilter

Cada diretiva AddFilter descreve a instalação de um serviço de driver como um filtro declarativo em uma posição ou nível de filtro. Esta diretiva é suportada no Windows 10 versão 1903 e posterior.

Em vez de usar um valor do Registro para especificar uma lista específica de filtros superiores ou inferiores a serem adicionados à pilha de dispositivos, os filtros declarativos registram filtros usando metadados. Esses metadados são usados para gerar a lista final de filtros no momento em que o dispositivo é iniciado. Os filtros declarativos podem ser usados em conjunto com o modelo herdado de usar os valores do Registro UpperFilters/LowerFilters. Para obter mais informações sobre o modelo de filtro declarativo, consulte Pedido de driver de filtro de dispositivo.

Uma diretiva AddFilter é usada dentro de um INF DDInstall. Filtra seção.

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

Inscrições

FilterName

Especifica o nome do filtro a ser instalado. Esse nome deve corresponder exatamente ao nome de um serviço de driver instalado no sistema.

bandeiras

Os sinalizadores não são usados no momento e devem ser 0, se especificado.

filter-install-section

Faz referência a uma seção definida pelo gravador INF que contém metadados sobre como o filtro deve ser adicionado à pilha de dispositivos.

Observações

Cada nome de seção criado pelo INF deve seguir as regras gerais para definir nomes de seção. Para obter mais informações sobre essas regras, consulte Regras gerais de sintaxe para arquivos INF.

Uma diretiva AddFilter deve fazer referência a um nomeado filter-install-section em outro lugar no arquivo INF. Cada secção tem a seguinte forma:

[filter-install-section]

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

Observação

Em cada filter-install-section, a posição do filtro ou o nível do filtro devem ser definidos, mas não ambos. Consulte de pedidos de driver de filtro de dispositivo para obter detalhes completos sobre como definir metadados de filtro

[filter-install-section]: Nível de Filtro

FilterLevel = {LevelName}

FilterLevel especifica o nome de um nível de filtro definido pelo pacote de driver base do dispositivo. O filtro é registrado com esse nome de nível, e a lista final de filtros é determinada quando o dispositivo é iniciado, montando a lista de filtros a partir dos filtros registrados de acordo com os metadados de nível de filtro fornecidos pelo pacote de driver base. Caso o nível de filtro especificado não esteja definido nos metadados do pacote de driver base, o filtro não será adicionado à pilha.

Para obter detalhes completos sobre o processo de definição dos metadados de nível de filtro e como a lista de filtros final é montada, consulte driver de filtro de dispositivo ordenando.

[filter-install-section]: PosiçãoFiltro

FilterPosition = {Upper / Lower}

FilterPosition especifica a posição de um filtro na pilha, como um filtro superior ou inferior. Se o pacote de driver base do dispositivo especificar metadados de nível de filtro, usar FilterPosition inserirá o filtro no nível de filtro padrão para os filtros de dispositivo superior ou inferior, conforme especificado. Se o pacote de driver base não fornecer esses metadados, o filtro será inserido nos filtros superiores ou inferiores especificados em ordem efetivamente arbitrária.

Ver também

Driver de filtro de dispositivo ordenando