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 à 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 boucle pas les données vers le pilote qui a envoyé la demande d’envoi. Un pilote surlysant 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 aucun impact 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 Hyper-V indicateurs d’envoi et de réception extensibles.
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 Hyper-V indicateurs d’envoi et de réception extensibles.
Valeur de retour
Aucun
Remarques
Après 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 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 lorsque l’opération d’envoi est terminée.
Un pilote de filtre doit définir le membre SourceHandle de chaque structure NET_BUFFER_LIST qu’elle provient de la même valeur qu’elle passe au paramètre NdisFilterHandle. Le handle de filtre fournit les informations requises par NDIS pour renvoyer 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éés.
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 FilterSendNetBufferLists fonction pour transmettre des demandes d’envoi de pilotes trop complexes. 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, elle abandonne la propriété des structures NET_BUFFER_LIST et toutes les ressources associées. NDIS appelle le filterSendNetBufferListsComplete fonction pour renvoyer les structures et les données au pilote de filtre. NDIS peut collecter les structures et les données de plusieurs demandes d’envoi dans une liste liée unique de structures NET_BUFFER_LIST avant de passer la liste à FilterSendNetBufferListsComplete.
Tant que NDIS n’appelle 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.