OID_PACKET_COALESCING_FILTER_MATCH_COUNT
NDIS emette 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 coalesci i pacchetti ricevuti se la scheda è abilitata per di 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 che hanno ricevuto filtri sulla scheda di rete.
Osservazioni
A partire da NDIS 6.30, i driver che supportano unione di pacchetti NDIS devono supportare richieste di query OID di OID_PACKET_COALESCING_FILTER_MATCH_COUNT.
Si noti che i driver che supportano la virtualizzazione di I/O radice singola (SR-IOV) o coda di macchine virtuali (VMQ) non sono necessarie per supportare le richieste di query OID di questo OID.
Un driver miniport che supporta l'unione dei 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 scaricano eccessivamente i 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 driver miniport deve cancellare il contatore solo se le condizioni seguenti sono vere:
Il driver miniport gestisce una richiesta di set OID di OID_PNP_SET_POWER per riprendere lo stato di alimentazione completa di NdisDeviceStateD0.
NDIS chiama la funzione miniportResetEx del driver miniport per reimpostare la scheda di rete sottostante.
Per altre informazioni sull'unione dei pacchetti, vedere NDIS Packet Coalescing.
Restituire i codici di stato
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
Richiesta OID completata.
NDIS_STATUS_INVALID_LENGTH
Il buffer delle informazioni era troppo breve. Il driver imposta il DATA. SET_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.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |