OID_RECEIVE_FILTER_PARAMETERS

Articolo
06/14/2023

Un driver overlying invia una richiesta di metodo OID di OID_RECEIVE_FILTER_PARAMETERS per ottenere i parametri di configurazione correnti di un filtro in una scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_FILTER_PARAMETERS . NDIS usa il membro FilterId nella struttura di input per identificare il filtro.

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.

Commenti

I filtri di ricezione NDIS vengono usati nelle interfacce NDIS seguenti:

Unione di pacchetti NDIS. Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Managing Packet Coalescing Receive Filters.For more information about how to use receive filters in this interface, see Managing Packet Coalescing Receive Filters.
Single Root I/O Virtualization (SR-IOV). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione di un filtro di ricezione su una porta virtuale.
VMQ (Virtual Machine Queue). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione e cancellazione dei filtri VMQ.

I driver eccessivamente rilasciano richieste di metodo OID di OID_RECEIVE_FILTER_PARAMETERS per ottenere i parametri di configurazione per un filtro di ricezione impostato su una scheda di rete. Questo include un filtro di ricezione impostato su una coda di ricezione VMQ o una porta virtuale SR-IOV (VPort), nonché un filtro di unione di pacchetti scaricato nel driver miniport.

Il driver overlying ha ottenuto l'identificatore di filtro da una richiesta di metodo OID precedente di OID_RECEIVE_FILTER_SET_FILTER o da richieste OID di OID_RECEIVE_FILTER_ENUM_FILTERS.

Codici di stato restituiti

NDIS gestisce la richiesta OID di OID_RECEIVE_FILTER_PARAMETERS per i driver miniport e restituisce uno dei codici di stato seguenti:

NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente. InformationBuffer punta a una struttura NDIS_RECEIVE_FILTER_PARAMETERS.

NDIS_STATUS_PENDING
La richiesta è in attesa di completamento. NDIS passa il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante al termine della richiesta.

NDIS_STATUS_INVALID_PARAMETER
Il driver o l'applicazione eccessiva ha fornito un identificatore di filtro non valido. Un identificatore di filtro non è valido se è zero o se specifica un filtro non definito.

NDIS_STATUS_INVALID_LENGTH
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. QUERY_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.

NDIS_STATUS_FAILURE
La richiesta non è riuscita per altri motivi.