Directive INF AddFilter
Chaque AddFilter directive décrit l’installation d’un service de pilote en tant que filtre déclaratif soit à une position de filtre, soit à un niveau de filtre. Cette directive est prise en charge dans Windows 10 version 1903 et les versions ultérieures.
Plutôt que d’utiliser une valeur de registre pour spécifier une liste spécifique de filtres supérieurs ou inférieurs à ajouter à la pile de périphériques, les filtres déclaratifs enregistrent les filtres à l’aide de métadonnées. Ces métadonnées sont utilisées pour générer la liste finale des filtres au moment où le périphérique est démarré. Les filtres déclaratifs peuvent être utilisés en conjonction avec le modèle hérité d’utilisation des valeurs de registre UpperFilters/LowerFilters. Pour plus d’informations sur le modèle de filtre déclaratif, veuillez consulter la section Ordonnancement des pilotes de filtre de périphérique.
Une directive AddFilter est utilisée dans une section INF DDInstall.Filters.
[DDInstall.Filters]
AddFilter=FilterName,[flags],filter-install-section
Entries
FilterName
Elle spécifie le nom du filtre à installer. Ce nom doit correspondre exactement au nom d’un service de pilote installé sur le système.
flags
Les indicateurs sont actuellement inutilisés et doivent être égaux à 0 s’ils sont spécifiés.
section d’installation de filtre
Fait référence à une section définie par le rédacteur de l’INF qui contient des métadonnées sur la manière dont le filtre doit être ajouté à la pile de périphériques.
Notes
Chaque nom de section créée par le rédacteur de l’INF doit suivre les règles générales de définition des noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
Une directive AddFilter doit faire référence à une section d’installation de filtre nommée ailleurs dans le fichier INF. Chacune de ces sections a la forme suivante :
[filter-install-section]
[FilterLevel = LevelName]
[FilterPosition = Upper / Lower]
Remarque
Dans chaque section d’installation de filtre, soit la position du filtre, soit le niveau du filtre doit être défini, mais pas les deux. Veuillez consulter la section Ordonnancement des pilotes de filtre de périphérique pour plus de détails sur la définition des métadonnées de filtre.
[section d’installation de filtre] : FilterLevel
FilterLevel = {LevelName}
FilterLevel spécifie le nom d’un niveau de filtre défini par le package de pilote de base du périphérique. Le filtre est enregistré avec ce nom de niveau, et la liste finale des filtres est déterminée lorsque le périphérique démarre en assemblant la liste des filtres à partir des filtres enregistrés conformément aux métadonnées du niveau de filtre fournies par le package de pilote de base. Dans le cas où le niveau de filtre spécifié n’est pas défini dans les métadonnées du package de pilote de base, le filtre n’est pas ajouté à la pile.
Pour plus de détails sur le processus de définition des métadonnées du niveau de filtre et sur la manière dont la liste finale des filtres est assemblée, veuillez consulter la section Ordonnancement des pilotes de filtre de périphérique.
[section d’installation de filtre] : FilterPosition
FilterPosition = {Upper / Lower}
FilterPosition spécifie la position d’un filtre dans la pile, soit en tant que filtre supérieur, soit en tant que filtre inférieur. Si le package de pilote de base du périphérique spécifie des métadonnées de niveau de filtre, l’utilisation de FilterPosition insérera le filtre dans le niveau de filtre par défaut pour les filtres supérieurs ou inférieurs du périphérique, tel que spécifié. Si le package de pilote de base ne fournit pas ces métadonnées, alors le filtre sera inséré dans les filtres supérieurs ou inférieurs spécifiés dans un ordre essentiellement arbitraire.