Compartilhar via


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. Essa diretiva tem suporte no Windows 10 versão 1903 e posterior.

Em vez de usar um valor de 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 de 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 é usado em uma seção INF DDInstall.Filters.

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

Entradas

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.

sinalizadores

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

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.

Comentários

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

Uma diretiva AddFilter deve fazer referência a filter-install-section em outra parte do arquivo INF. Cada uma dessas seções 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 Pedido de driver de filtro de dispositivo para obter detalhes completos sobre como definir metadados de filtro

[filter-install-section]: FilterLevel

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 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 seja 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 pedido de driver de filtro de dispositivo.

[filter-install-section]: FilterPosition

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, o uso de 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 superior ou inferior especificados em ordem efetivamente arbitrária.

Confira também

Pedido de driver de filtro de dispositivo