OID_RECEIVE_FILTER_GLOBAL_PARAMETERS
I driver che eseguono eccessivamente richieste di query OID di OID_RECEIVE_FILTER_GLOBAL_PARAMETERS per ottenere i parametri di filtro di ricezione globali di una scheda di rete.
Una volta restituito correttamente dalla richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_RECEIVE_FILTER_GLOBAL_PARAMETERS .
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.
A partire da NDIS 6.20, i driver di protocollo usano OID_RECEIVE_FILTER_GLOBAL_PARAMETERS per eseguire query sui parametri di configurazione globale correnti per la ricezione di filtri in una scheda di rete. Ad esempio, i driver di protocollo possono usare questo OID per determinare se i tipi di filtri di ricezione o le code di ricezione sono abilitati o disabilitati.
Codici di stato restituiti
NDIS gestisce la richiesta di query OID di OID_RECEIVE_FILTER_GLOBAL_PARAMETERS per i driver miniport e restituisce uno dei codici di stato seguenti:
NDIS_STATUS_SUCCESS
La richiesta è stata completata correttamente.
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_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_INVALID_PARAMETER
La richiesta non è riuscita perché ha tentato di abilitare una funzionalità non supportata dalla scheda di rete sottostante.
NDIS_STATUS_FAILURE
La richiesta non è riuscita per altri motivi.
Requisiti
Versione |
Supportato in NDIS 6.20 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |