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.