NdisFSendNetBufferListsComplete, fonction (ndis.h)

Article
02/07/2025

Les pilotes de filtre appellent la fonction NdisFSendNetBufferListsComplete pour renvoyer une liste liée de structures NET_BUFFER_LIST à un pilote overlying et retourner l’état final 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 au FilterSendNetBufferLists fonction.

[in] SendCompleteFlags

Indicateurs NDIS qui 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_COMPLETE_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_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 Hyper-V indicateurs d’envoi et de réception extensibles.

Remarque Si chaque paquet de la liste liée de 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 requête.

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

Valeur de retour

Aucun

Remarques

Un pilote de filtre appelle la fonction NdisFSendNetBufferListsComplete pour effectuer les requêtes envoyées par NDIS au pilote FilterSendNetBufferLists fonction. Le pilote de filtre spécifie une liste liée de structures NET_BUFFER_LIST associées aux demandes d’envoi terminées. Bien que l’état des demandes d’envoi soit en attente, le pilote de filtre conserve la propriété des structures NET_BUFFER_LIST et toutes les ressources associées aux structures NET_BUFFER_LIST.

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

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

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Bureau
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	<= DISPATCH_LEVEL
règles de conformité DDI	Irql_Filter_Driver_Function(ndis)