Partager via


OID_PACKET_COALESCING_FILTER_MATCH_COUNT

NDIS émet une requête de 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 fusion 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 par l’appelant. Avant un retour réussi de la requête de requête, le pilote met à jour la variable ULONG64 avec le nombre de paquets qui ont mis en correspondance des filtres de réception sur la carte réseau.

Remarques

À compter de NDIS 6.30, les pilotes qui prennent en charge paquet NDIS coalescing doivent prendre en charge les requêtes de requête OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT.

Remarque Pilotes qui prennent en charge la virtualisation d’E/S racine unique (SR-IOV) ou file d’attente de machine virtuelle (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 des paquets doit incrémenter un compteur ULONG64 pour chaque paquet reçu qui a été fusionné sur la carte réseau. Les paquets sont fusionnés s’ils correspondent à un filtre de réception, qui surchargé les pilotes téléchargent sur le pilote miniport via les requêtes 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 de 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 de requête OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT. Le pilote miniport doit uniquement effacer le compteur si les conditions suivantes sont remplies :

  • Le pilote miniport gère une demande de jeu d’OID de OID_PNP_SET_POWER pour reprendre à un état de puissance totale de NdisDeviceStateD0.

  • NDIS appelle la fonction MiniportResetEx du pilote miniport pour réinitialiser la carte réseau sous-jacente.

Pour plus d’informations sur la fusion des paquets, consultez de fusion des paquets NDIS.

Retourner des codes d’état

Le pilote miniport retourne l’un des codes d’état suivants pour la requête de méthode OID de OID_PACKET_COALESCING_FILTER_MATCH_COUNT :

NDIS_STATUS_SUCCESS
La requête 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 le DATA. SET_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.

NDIS_STATUS_FAILURE
La demande a échoué pour d’autres raisons.

Exigences

Version

Prise en charge dans NDIS 6.30 et versions ultérieures.

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

MiniportResetEx

NDIS_OID_REQUEST

OID_PNP_SET_POWER

OID_RECEIVE_FILTER_SET_FILTER