Direttiva INF AddFilter

Ogni direttiva AddFilter descrive l'installazione di un servizio driver come filtro dichiarativo in una posizione o un livello di filtro. Questa direttiva è supportata in Windows 10 versione 1903 e successiva.

Anziché usare un valore del Registro di sistema per specificare un elenco specifico di filtri superiori o inferiori da aggiungere allo stack di dispositivi, i filtri dichiarativi registrano i filtri usando i metadati. Questi metadati vengono usati per generare l'elenco finale di filtri al momento dell'avvio del dispositivo. I filtri dichiarativi possono essere usati insieme al modello legacy di usando i valori del Registro di sistema UpperFilters/LowerFilters. Per altre informazioni sul modello di filtro dichiarativo, vedere Ordinamento driver filtro dispositivo.

Una direttiva AddFilter viene usata all'interno di una DDInstall INF. Sezione Filtri.

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

Voci

FilterName

Specifica il nome del filtro da installare. Questo nome deve corrispondere esattamente al nome di un servizio driver installato nel sistema.

flags

I flag sono attualmente inutilizzati e devono essere 0 se specificato.

filter-install-section

Fa riferimento a una sezione definita da INF-writer che contiene metadati sulla modalità di aggiunta del filtro allo stack di dispositivi.

Commenti

Ogni nome di sezione creato da INF-writer deve seguire le regole generali per definire i nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

Una direttiva AddFilter deve fare riferimento a una sezione denominata filter-install-section altrove nel file INF. Ogni sezione di questo tipo ha il formato seguente:

[filter-install-section]

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

Nota

In ogni sezione del filtro, la posizione del filtro o il livello di filtro deve essere definito, ma non entrambi. Per informazioni dettagliate sulla definizione dei metadati dei filtri dei filtri, vedere l'ordinamento del driver di filtro del dispositivo per informazioni dettagliate sulla definizione dei metadati dei filtri

[filter-install-section]: FilterLevel

FilterLevel = {LevelName}

FilterLevel specifica il nome di un livello di filtro definito dal pacchetto driver di base del dispositivo. Il filtro viene registrato con tale nome di livello e l'elenco finale dei filtri viene determinato quando il dispositivo inizia assemblando l'elenco di filtri dai filtri registrati in base ai metadati a livello di filtro forniti dal pacchetto driver di base. Nel caso in cui il livello di filtro specificato non sia definito nei metadati del pacchetto driver di base, il filtro non viene aggiunto allo stack.

Per informazioni dettagliate sul processo di definizione dei metadati a livello di filtro e sul modo in cui viene assemblato l'elenco di filtri finali, vedere ordinamento del driver di filtro del dispositivo.

[filter-install-section]: FilterPosition

FilterPosition = {Upper / Lower}

FilterPosition specifica la posizione di un filtro nello stack, come filtro superiore o inferiore. Se il pacchetto del driver di base del dispositivo specifica i metadati del livello di filtro, l'uso di FilterPosition inserisce il filtro nel livello di filtro predefinito per i filtri del dispositivo superiore o inferiore, come specificato. Se il pacchetto del driver di base non fornisce questi metadati, il filtro verrà inserito nel filtro superiore o inferiore specificato in ordine arbitrario.

Vedere anche

Ordinamento del driver di filtro del dispositivo