NdisFSendNetBufferLists, fonction (ndis.h)

Les pilotes de filtre appellent la fonction NdisFSendNetBufferLists pour envoyer une liste de mémoires tampons de données réseau.

Syntaxe

void NdisFSendNetBufferLists(
  [in] NDIS_HANDLE                       NdisFilterHandle,
       __drv_aliasesMem PNET_BUFFER_LIST NetBufferList,
  [in] NDIS_PORT_NUMBER                  PortNumber,
  [in] ULONG                             SendFlags
);

Paramètres

[in] NdisFilterHandle

Handle NDIS qui identifie ce module de filtre. NDIS a passé le handle au pilote de filtre dans un appel à la fonction FilterAttach .

NetBufferList

Pointeur vers une liste liée de structures NET_BUFFER_LIST . Chaque structure NET_BUFFER_LIST décrit une liste de structures NET_BUFFER .

[in] PortNumber

Numéro de port qui identifie un port d’adaptateur miniport. Les numéros de port de l’adaptateur Miniport sont attribués en appelant la fonction NdisMAllocatePort . Une valeur zéro identifie le port par défaut d’un adaptateur miniport.

[in] SendFlags

Indicateurs qui définissent des attributs pour l’opération d’envoi. Les indicateurs peuvent être combinés avec une opération OR. Pour effacer tous les indicateurs, définissez ce membre sur zéro. Cette fonction prend en charge les indicateurs suivants :

NDIS_SEND_FLAGS_DISPATCH_LEVEL

Spécifie que le runtime d’intégration actuel est DISPATCH_LEVEL. Pour plus d’informations sur cet indicateur, consultez Dispatch IRQL Tracking.

NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK

Spécifie que NDIS doit vérifier la bouclage. Par défaut, NDIS ne retourne pas de données au pilote qui a envoyé la demande d’envoi. Un pilote overlying peut remplacer ce comportement en définissant cet indicateur. Lorsque cet indicateur est défini, NDIS identifie toutes les structures NET_BUFFER qui contiennent des données qui correspondent aux critères de réception de la liaison. NDIS indique NET_BUFFER structures qui correspondent aux critères du pilote overlying. Cet indicateur n’a aucune incidence sur la vérification de la bouclage ou de la bouclage, sur d’autres liaisons.

NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE

Si cet indicateur est défini, tous les paquets d’une liste liée de structures NET_BUFFER_LIST proviennent du même port source de commutateur extensible Hyper-V.

Pour plus d’informations, consultez indicateurs d’envoi et de réception de commutateur extensible Hyper-V.

Note Si chaque paquet de la liste liée de NET_BUFFER_LIST structures utilise le même port source, l’extension doit définir l’indicateur NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE dans le paramètre SendCompleteFlags de NdisFSendNetBufferListsComplete lorsqu’elle termine la demande d’envoi.
 
Note Cet indicateur est disponible dans NDIS 6.30 et versions ultérieures.
 

NDIS_SEND_FLAGS_SWITCH_DESTINATION_GROUP

Si cet indicateur est défini, tous les paquets d’une liste liée de structures NET_BUFFER_LIST doivent être transférés vers le même port de destination de commutateur extensible.

Pour plus d’informations, consultez indicateurs d’envoi et de réception de commutateur extensible Hyper-V.

Note Cet indicateur est disponible dans NDIS 6.30 et versions ultérieures.
 

Valeur de retour

None

Remarques

Une fois qu’un pilote de filtre appelle la fonction NdisFSendNetBufferLists , NDIS envoie les structures NET_BUFFER_LIST aux pilotes sous-jacents.

Un pilote de filtre peut provenir des demandes d’envoi, ou il peut filtrer les demandes qu’il reçoit de pilotes trop lourds. Si le pilote de filtre provient des demandes d’envoi, le pilote doit allouer des pools de mémoires tampons. Le pilote de filtre alloue chaque structure NET_BUFFER_LIST à partir d’un pool.

Le pilote de filtre peut préallouer NET_BUFFER_LIST structures ou allouer les structures juste avant d’appeler NdisFSendNetBufferLists , puis les libérer une fois l’opération d’envoi terminée.

Un pilote de filtre doit définir le membre SourceHandle de chaque structure NET_BUFFER_LIST qu’il provient de la même valeur qu’il transmet au paramètre NdisFilterHandle . Le handle de filtre fournit les informations requises par NDIS pour retourner la structure NET_BUFFER_LIST au pilote de filtre. Le pilote de filtre ne doit pas modifier le membre SourceHandle dans les structures NET_BUFFER_LIST qu’il n’a pas créées.

Avant d’appeler NdisFSendNetBufferLists, un pilote de filtre peut définir des informations qui accompagnent la demande d’envoi avec la macro NET_BUFFER_LIST_INFO . Les pilotes sous-jacents peuvent récupérer ces informations avec la macro NET_BUFFER_LIST_INFO .

NDIS appelle les pilotes de filtre Fonction FilterSendNetBufferLists pour transmettre des demandes d’envoi à partir de pilotes overlying. Un pilote de filtre peut transmettre ces requêtes en transmettant les structures T NET_BUFFER_LISTqu’il a reçues dans FilterSendNetBufferLists à NdisFSendNetBufferLists.

Dès qu’un pilote de filtre appelle la fonction NdisFSendNetBufferLists , il abandonne la propriété des structures NET_BUFFER_LIST et de toutes les ressources associées. NDIS appelle le Fonction FilterSendNetBufferListsComplete pour retourner les structures et les données au pilote de filtre. NDIS peut collecter les structures et les données à partir de plusieurs requêtes d’envoi dans une seule liste liée de structures NET_BUFFER_LIST avant de passer la liste à FilterSendNetBufferListsComplete.

Tant que NDIS n’appelle pas FilterSendNetBufferListsComplete, l’état actuel de la demande d’envoi n’est pas disponible pour le pilote de filtre. Un pilote de filtre libère temporairement la propriété de toutes les ressources associées à une demande d’envoi lorsqu’elle appelle NdisFSendNetBufferLists. Un pilote de filtre ne doit jamais essayer d’examiner les structures NET_BUFFER_LIST ou les données associées après avoir appelé NdisFSendNetBufferLists.

Note Un pilote de filtre doit suivre les demandes d’envoi qu’il provient et s’assurer qu’il n’appelle pas le Fonction NdisFSendNetBufferListsComplete lorsque ces requêtes sont terminées.
 

Configuration requise

   
Client minimal pris en charge Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_Filter_Driver_Function(ndis)

Voir aussi

FilterAttach

FilterSendNetBufferLists

FilterSendNetBufferListsComplete

NET_BUFFER

NET_BUFFER_LIST

NET_BUFFER_LIST_INFO

NdisMAllocatePort