Condividi tramite


OID_RECEIVE_FILTER_PARAMETERS

Un driver che esegue eccessivamente 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:

Osservazioni

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

L'overlying driver emette 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. Include un filtro di ricezione impostato su una coda di ricezione VMQ o SR-IOV porta virtuale (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.

Restituire i codici di stato

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. L'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 dopo il completamento della richiesta.

NDIS_STATUS_INVALID_PARAMETER
L'applicazione o il driver overlying 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 l'DATA. QUERY_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.

NDIS_STATUS_FAILURE
La richiesta non è riuscita per altri motivi.

Fabbisogno

Versione

Supportato in NDIS 6.20 e versioni successive.

Intestazione

Ntddndis.h (include Ndis.h)

Vedere anche

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER