INF AddFilter Directive

Chaque directive AddFilter décrit l’installation d’un service de pilote en tant que filtre déclaratif dans une position de filtre ou un niveau. Cette directive est prise en charge dans Windows 10 version 1903 et ultérieure.

Au lieu d’utiliser une valeur de Registre pour spécifier une liste spécifique de filtres supérieurs ou inférieurs à ajouter à la pile d’appareils, les filtres déclaratifs inscrivent des 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 du démarrage de l’appareil. Les filtres déclaratifs peuvent être utilisés conjointement avec le modèle hérité de l’utilisation des valeurs de Registre UpperFilters/LowerFilters. Pour plus d’informations sur le modèle de filtre déclaratif, consultez Classement des pilotes de filtre d’appareil.

Une directive AddFilter est utilisée dans un DDInstall INF. Section Filtres.

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

Entrées

FilterName

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 0 si spécifiés.

filter-install-section

Fait référence à une section définie par INF-writer qui contient des métadonnées sur la façon dont le filtre doit être ajouté à la pile d’appareils.

Notes

Chaque nom de section créé par un enregistreur INF doit suivre les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.

Une directive AddFilter doit référencer une section nommée filter-install-section ailleurs dans le fichier INF. Chacune de ces sections a la forme suivante :

[filter-install-section]

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

Notes

Dans chaque section d’installation de filtre, la position du filtre ou le niveau de filtre doivent être définis, mais pas les deux. Pour plus d’informations sur la définition des métadonnées de filtre, consultez Classement des pilotes de filtre d’appareil

[filter-install-section] : FilterLevel

FilterLevel = {LevelName}

FilterLevel spécifie le nom d’un niveau de filtre défini par le package de pilotes de base de l’appareil. Le filtre est inscrit avec ce nom de niveau et la liste finale des filtres est déterminée lorsque l’appareil commence par assembler la liste de filtres à partir des filtres inscrits conformément aux métadonnées de niveau de filtre fournies par le package de pilote de base. Si le niveau de filtre spécifié n’est pas défini dans les métadonnées du package de pilotes de base, le filtre n’est pas ajouté à la pile.

Pour plus d’informations sur le processus de définition des métadonnées de niveau de filtre et sur la façon dont la liste de filtres finale est assemblée, consultez Classement des pilotes de filtre de périphérique.

[filter-install-section] : FilterPosition

FilterPosition = {Upper / Lower}

FilterPosition spécifie la position d’un filtre sur la pile, en tant que filtre supérieur ou inférieur. Si le package de pilotes de base de l’appareil spécifie des métadonnées de niveau de filtre, l’utilisation de FilterPosition insère le filtre dans le niveau de filtre par défaut pour les filtres d’appareil supérieurs ou inférieurs, comme spécifié. Si le package de pilote de base ne fournit pas ces métadonnées, le filtre est inséré dans les filtres supérieurs ou inférieurs spécifiés dans un ordre arbitraire.

Voir aussi

Classement des pilotes de filtre de périphérique