OID_PACKET_COALESCING_FILTER_MATCH_COUNT
NDIS émet une requête OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT pour obtenir le nombre de paquets mis en cache ou fusionnés sur la carte réseau. La carte réseau fusionne les paquets reçus si l’adaptateur est activé pour le regroupement de paquets NDIS et que le paquet correspond à un filtre de réception.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une variable ULONG64 allouée à l’appelant. Avant un retour réussi de la demande de requête, le pilote met à jour la variable ULONG64 avec le nombre de paquets qui ont correspond aux filtres de réception sur la carte réseau.
Notes
À compter de NDIS 6.30, les pilotes qui prennent en charge le regroupement de paquets NDIS doivent prendre en charge les requêtes OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT.
Note Les pilotes qui prennent en charge les interfaces de virtualisation d’E/S racine unique (SR-IOV) ou de file d’attente de machines virtuelles (VMQ) ne sont pas nécessaires pour prendre en charge les requêtes de requête OID de cet OID.
Un pilote miniport qui prend en charge la fusion de paquets doit incrémenter un compteur ULONG64 pour chaque paquet reçu qui a été coalescisé sur la carte réseau. Les paquets sont fusionnés s’ils correspondent à un filtre de réception, que les pilotes trop longs téléchargent sur le pilote miniport via les demandes de méthode OID de OID_RECEIVE_FILTER_SET_FILTER.
Le pilote retourne la valeur de ce compteur lorsqu’il gère une requête OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT.
Le pilote miniport ne doit pas effacer le compteur après avoir géré la requête OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT. Le pilote miniport doit effacer le compteur uniquement si les conditions suivantes sont remplies :
Le pilote miniport gère une demande d’ensemble OID de OID_PNP_SET_POWER de reprendre l’état pleine puissance de NdisDeviceStateD0.
NDIS appelle la fonction MiniportResetEx du pilote miniport pour réinitialiser la carte réseau sous-jacente.
Pour plus d’informations sur le regroupement de paquets, consultez Coalescing de paquets NDIS.
Retourner les codes status
Le pilote miniport retourne l’un des codes status suivants pour la demande de méthode OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT :
NDIS_STATUS_SUCCESS
La demande OID s’est terminée avec succès.
NDIS_STATUS_INVALID_LENGTH
La mémoire tampon d’informations était trop courte. Le pilote définit les données. SET_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE
La demande a échoué pour d’autres raisons.
Spécifications
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |