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.
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.
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.
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) |