NdisFSendNetBufferListsComplete, fonction (ndis.h)

Article
02/29/2024

Les pilotes de filtre appellent la fonction NdisFSendNetBufferListsComplete pour renvoyer une liste liée de structures NET_BUFFER_LIST à un pilote overlying et pour retourner la status finale d’une demande d’envoi.

Syntaxe

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

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 . Le pilote de filtre a reçu les structures NET_BUFFER_LIST dans les appels précédents à Fonction FilterSendNetBufferLists .

[in] SendCompleteFlags

Indicateurs NDIS qui 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_COMPLETE_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_COMPLETE_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 du commutateur extensible Hyper-V.

Note Si chaque paquet de la liste liée des structures NET_BUFFER_LIST utilise le même port source, l’extension doit définir l’indicateur NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE dans le paramètre SendFlags de NdisFSendNetBufferLists lorsqu’elle envoie la demande.

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

Valeur de retour

None

Remarques

Un pilote de filtre appelle la fonction NdisFSendNetBufferListsComplete pour effectuer les demandes d’envoi que NDIS a effectuées auprès du pilote Fonction FilterSendNetBufferLists . Le pilote de filtre spécifie une liste liée de structures NET_BUFFER_LIST associées aux demandes d’envoi terminées. Pendant que la status des demandes d’envoi est en attente, le pilote de filtre conserve la propriété des structures NET_BUFFER_LIST et de toutes les ressources associées aux structures NET_BUFFER_LIST.

Le pilote de filtre peut effectuer l’envoi des demandes dans n’importe quel ordre. Par exemple, le pilote de filtre peut concaténer les listes de structure NET_BUFFER_LIST à partir de plusieurs appels FilterSendNetBufferLists ou fractionner une liste à partir d’un appel FilterSendNetBufferLists . Toutefois, le pilote de filtre ne doit pas modifier la liste des structures NET_BUFFER associées à une structure NET_BUFFER_LIST .

Note Un pilote de filtre doit effectuer le suivi des demandes d’envoi dont il provient et s’assurer qu’il n’appelle pas le Fonction NdisFSendNetBufferListsComplete lorsque ces demandes sont terminées.

Configuration requise

Condition requise	Valeur
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)