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 successive.
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 dei 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 dei driver di filtro del dispositivo.
Una direttiva AddFilter viene usata all'interno di un inF DDInstall. Sezione Filtri .
[DDInstall.Filters]
AddFilter=FilterName,[flags],filter-install-section
whse.
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 specificati.
filter-install-section
Fa riferimento a una sezione definita dal writer INF che contiene metadati sulla modalità di aggiunta del filtro allo stack di dispositivi.
Osservazioni:
Ogni nome di sezione creato da INF-writer deve seguire le regole generali per la definizione dei 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 filter-install-section denominata 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 filter-install-section, la posizione del filtro o il livello di filtro deve essere definito, ma non entrambi. Per informazioni dettagliate sulla definizione dei metadati del filtro dei filtri, vedere Ordinamento dei driver di filtro dei dispositivi
[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 finale, vedere Ordinamento dei driver di filtro dei dispositivi.
[filter-install-section]: FilterPosition
FilterPosition = {Upper / Lower}
FilterPosition specifica la posizione di un filtro nello stack, come filtro superiore o inferiore. Se il pacchetto driver di base del dispositivo specifica i metadati del livello di filtro, l'uso di FilterPosition inserirà il filtro nel livello di filtro predefinito per i filtri del dispositivo superiore o inferiore, come specificato. Se il pacchetto driver di base non fornisce questi metadati, il filtro verrà inserito nei filtri superiore o inferiore specificati in ordine arbitrario.