NdisMCoSendNetBufferListsComplete, fonction (ndis.h)

  • Article

La fonction NdisMCoSendNetBufferListsComplete retourne une liste liée de structures NET_BUFFER_LIST à un pilote qui se superpose et retourne la status finale d’une demande d’envoi CoNDIS.

Syntaxe

void NdisMCoSendNetBufferListsComplete(
  [in] IN NDIS_HANDLE      NdisVcHandle,
  [in] IN PNET_BUFFER_LIST NetBufferLists,
  [in] IN ULONG            SendCompleteFlags
);

Paramètres

[in] NdisVcHandle

Handle qui identifie une connexion virtuelle (VC). Le pilote miniport a obtenu ce handle en tant que paramètre d’entrée pour sa fonction MiniportCoCreateVc , soit lorsqu’un client a configuré un appel sortant, soit lorsque le gestionnaire d’appels a créé un vc pour un point d’accès de service inscrit au client (SAP) pour indiquer une notification d’appel entrante.

[in] NetBufferLists

Pointeur vers une liste liée de structures NET_BUFFER_LIST . Le pilote miniport a reçu les structures NET_BUFFER_LIST lors des appels précédents à son Fonction MiniportCoSendNetBufferLists .

[in] SendCompleteFlags

Indicateurs NDIS qui peuvent être combinés à une opération OR au niveau du bit. Pour effacer tous les indicateurs, définissez ce paramètre sur zéro. NdisMCoSendNetBufferListsComplete prend en charge l’indicateur NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL, qui ; si défini, indique que l’IRQL actuel est DISPATCH_LEVEL. Pour plus d’informations sur cet indicateur, consultez Dispatch IRQL Tracking.

Valeur de retour

None

Remarques

Un pilote miniport appelle NdisMCoSendNetBufferListsComplete pour effectuer les demandes que NDIS a adressées au pilote Fonction MiniportCoSendNetBufferLists . Le pilote miniport spécifie une liste liée de structures NET_BUFFER_LIST associées aux demandes d’envoi terminées.

Tant que la status des demandes d’envoi est en attente, le pilote miniport conserve la propriété des structures NET_BUFFER_LIST et de toutes les ressources associées aux structures NET_BUFFER_LIST.

Une fois qu’un pilote miniport appelle NdisMCoSendNetBufferListsComplete, NDIS retourne les structures de NET_BUFFER_LIST et les données associées au pilote qui est à l’origine de la demande d’envoi.

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

Le pilote miniport doit définir l’un des codes status suivants dans le membre Status de chaque structure NET_BUFFER_LIST que le paramètre NetBufferLists spécifie :

L’appel d’un pilote miniport à NdisMCoSendNetBufferListsComplete n’indique pas nécessairement que les données d’une demande d’envoi ont été transmises sur le réseau. Par exemple, les données peuvent être mises en file d’attente dans le matériel de la carte réseau.

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_MCO_Function(ndis)

Voir aussi

MiniportCancelSend

MiniportCoCreateVc

MiniportCoSendNetBufferLists

NET_BUFFER

NET_BUFFER_LIST