Fonction NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)

  • Article

Appelez la fonction NdisAdvanceNetBufferListDataStart pour libérer l’espace de données qui a été revendiqué dans les appels précédents au Fonction NdisRetreatNetBufferListDataStart .

Syntaxe

NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferListDataStart(
  [in] NET_BUFFER_LIST     *NetBufferList,
  [in] ULONG               DataOffsetDelta,
  [in] BOOLEAN             FreeMdl,
       NET_BUFFER_FREE_MDL *FreeMdlMdlHandler
);

Paramètres

[in] NetBufferList

Pointeur vers une structure de NET_BUFFER_LIST précédemment allouée.

[in] DataOffsetDelta

Quantité d’espace de données utilisé à libérer.

[in] FreeMdl

Si TRUE et NDIS ont alloué de la mémoire pour satisfaire l’appel NdisRetreatNetBufferListDataStart correspondant, cette fonction libère la mémoire qui a été allouée et la MDL associée.

FreeMdlMdlHandler

Point d’entrée facultatif pour une fonction NetFreeMdl . Si l’appelant spécifie un point d’entrée pour la fonction NetFreeMdl , NDIS appelle NetFreeMdl pour libérer un MDL et de la mémoire.

Valeur de retour

None

Remarques

NdisAdvanceNetBufferListDataStart libère l’espace de données utilisé pour toutes les structures NET_BUFFER dans une structure de NET_BUFFER_LIST . Si FreeMdl a la valeur TRUE et Mémoire allouée NdisRetreatNetBufferListDataStart pour répondre à la demande d’allocation correspondante,
NdisAdvanceNetBufferListDataStart libère la mémoire allouée. Appeler cette fonction équivaut à appeler NdisAdvanceNetBufferDataStart pour chaque structure NET_BUFFER sur la structure NET_BUFFER_LIST. Toutefois, l’appel de NdisAdvanceNetBufferListDataStart est plus efficace.

Lorsque les pilotes de protocole appellent NdisAdvanceNetBufferListDataStart sur le chemin de réception pour accéder aux différents en-têtes de transport, la chaîne MDL ne doit pas être modifiée et FreeMdl a la valeur FALSE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible Universal
En-tête ndis/nblapi.h (include ndis.h)
Bibliothèque Ndis.lib
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_NetBuffer_Function(ndis)

Voir aussi

NET_BUFFER

NET_BUFFER_LIST

NdisAdvanceNetBufferDataStart NdisRetreatNetBufferListDataStart

NetAllocateMdl

NetFreeMdl