Fonction NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)
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) |