Esecuzione di query sui filtri di ricezione di coalescenza dei pacchetti
I driver e le applicazioni eccessivamente in grado di eseguire query sui filtri di unione dei pacchetti scaricati in un driver miniport eseguendo le operazioni seguenti:
Richiedere un elenco enumerato dei filtri di ricezione sul driver miniport inviando una richiesta di metodo OID di OID_RECEIVE_FILTER_ENUM_FILTERS. Per altre informazioni, vedere Enumerazione dei filtri di ricezione in un driver Miniport.
Richiedere i parametri del criterio di test per un filtro di ricezione sul driver miniport inviando una richiesta di metodo OID di OID_RECEIVE_FILTER_PARAMETERS. Per altre informazioni, vedere Esecuzione di query sui filtri di ricezione in un driver Miniport
NDIS gestisce le richieste OID del metodo OID_RECEIVE_FILTER_ENUM_FILTERS e OID_RECEIVE_FILTER_PARAMETERS per i driver miniport. NDIS ha ottenuto le informazioni da una cache interna dei dati ricevuti dalla richiesta OID OID_RECEIVE_FILTER_SET_FILTER .
Enumerazione dei filtri di ricezione in un driver Miniport
Per ottenere un elenco di tutti i filtri di ricezione di unione dei pacchetti che sono stati scaricati in un driver miniport, i driver e le applicazioni overlying emettono una richiesta di metodo OID di OID_RECEIVE_FILTER_ENUM_FILTERS. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_FILTER_INFO_ARRAY .
Nota Quando l'applicazione o il driver overlying inizializza la struttura NDIS_RECEIVE_FILTER_INFO_ARRAY , deve impostare il membro QueueId su NDIS_DEFAULT_RECEIVE_QUEUE_ID.
Una volta restituito correttamente dalla richiesta del metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer è formattato per contenere quanto segue:
Struttura NDIS_RECEIVE_FILTER_INFO_ARRAY che specifica un elenco di filtri di ricezione attualmente configurati in un driver miniport.
Matrice di strutture NDIS_RECEIVE_FILTER_INFO su un filtro di ricezione attualmente configurato in un driver miniport.
Esecuzione di query sui parametri di un filtro di ricezione in un driver Miniport
Per ottenere i parametri di un filtro di ricezione di unione di pacchetti specifico scaricato nel driver miniport, i driver o le applicazioni emettono una richiesta di metodo OID di OID_RECEIVE_FILTER_PARAMETERS. Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_FILTER_PARAMETERS . Il driver o l'applicazione eccessivamente inizializza la struttura NDIS_RECEIVE_FILTER_PARAMETERS impostando il membro FilterId sul valore ID diverso da zero del filtro i cui parametri devono essere restituiti.
Nota Il driver overlying ha ottenuto l'ID filtro da una richiesta di metodo OID precedente di OID_RECEIVE_FILTER_SET_FILTER o OID_RECEIVE_FILTER_ENUM_FILTERS. L'applicazione può ottenere l'ID filtro solo da una richiesta di metodo OID precedente di OID_RECEIVE_FILTER_ENUM_FILTERS.
Una volta restituito correttamente dalla richiesta del metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a un buffer. Questo buffer è formattato per contenere quanto segue:
Struttura NDIS_RECEIVE_FILTER_PARAMETERS che specifica i parametri per un filtro di ricezione NDIS.
Matrice di strutture NDIS_RECEIVE_FILTER_FIELD_PARAMETERS che specifica il criterio di test del filtro per un campo in un'intestazione di pacchetto di rete.