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:
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.
Osservazioni
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.
Virtualizzazione I/O radice singola (SR-IOV). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere Impostazione di un filtro di ricezione in una porta virtuale.
coda di macchine virtuali (VMQ). Per altre informazioni su come usare i filtri di ricezione in questa interfaccia, vedere impostazione e cancellazione dei filtri VMQ.
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
OID_RECEIVE_FILTER_ENUM_FILTERS