OID_PACKET_COALESCING_FILTER_MATCH_COUNT

NDIS invia una richiesta di query OID di OID_PACKET_COALESCING_FILTER_MATCH_COUNT per ottenere il numero di pacchetti memorizzati nella cache o uniti nella scheda di rete. La scheda di rete coalesces ha ricevuto pacchetti se la scheda è abilitata per la unione dei pacchetti NDIS e il pacchetto corrisponde a un filtro di ricezione.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una variabile ULONG64 allocata dal chiamante. Prima di restituire correttamente dalla richiesta di query, il driver aggiorna la variabile ULONG64 con il numero di pacchetti corrispondenti ai filtri di ricezione nella scheda di rete.

Commenti

A partire da NDIS 6.30, i driver che supportano l'unione dei pacchetti NDIS devono supportare le richieste di query OID di OID_PACKET_COALESCING_FILTER_MATCH_COUNT.

Nota I driver che supportano le singole interfacce di virtualizzazione I/O radice (SR-IOV) o VMQ (Virtual Machine Queue) non sono necessari per supportare le richieste di query OID di questo OID.

Un driver miniport che supporta l'unione di pacchetti deve incrementare un contatore ULONG64 per ogni pacchetto ricevuto unito alla scheda di rete. I pacchetti vengono uniti se corrispondono a un filtro di ricezione, che esegue il download overly dei driver nel driver miniport tramite richieste di metodo OID di OID_RECEIVE_FILTER_SET_FILTER.

Il driver restituisce il valore di questo contatore quando gestisce una richiesta di query OID di OID_PACKET_COALESCING_FILTER_MATCH_COUNT.

Il driver miniport non deve cancellare il contatore dopo che gestisce la richiesta di query OID di OID_PACKET_COALESCING_FILTER_MATCH_COUNT. Il conducente miniport deve cancellare il contatore solo se le condizioni seguenti sono vere:

Per altre informazioni sull'unione dei pacchetti, vedere Unione di pacchetti NDIS.

Codici di stato restituiti

Il driver miniport restituisce uno dei codici di stato seguenti per la richiesta del metodo OID di OID_PACKET_COALESCING_FILTER_MATCH_COUNT:

NDIS_STATUS_SUCCESS
La richiesta OID è stata completata correttamente.

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

NDIS_STATUS_FAILURE
La richiesta non è riuscita per altri motivi.

Requisiti

Versione

Supportato in NDIS 6.30 e versioni successive.

Intestazione

Ntddndis.h (include Ndis.h)

Vedi anche

MiniportResetEx

NDIS_OID_REQUEST

OID_PNP_SET_POWER

OID_RECEIVE_FILTER_SET_FILTER