NdisAdvanceNetBufferListDataStart, fonction (ndis/nblapi.h)
Appelez la fonction NdisAdvanceNetBufferListDataStart pour libérer de 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é de espace de données utilisé à libérer.
[in] FreeMdl
Si true et la mémoire allouée NDIS pour satisfaire les NdisRetreatNetBufferListDataStart appel correspondants, cette fonction libère la mémoire allouée et le MDL associé.
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 une mémoire.
Valeur de retour
Aucun
Remarques
NdisAdvanceNetBufferListDataStart libère 'espace de données utilisé pour toutes les structures de NET_BUFFER dans une structure NET_BUFFER_LIST. Si FreeMdl est TRUE et
NdisRetreatNetBufferListDataStart mémoire allouée 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 de NET_BUFFER sur la structure NET_BUFFER_LIST.
Toutefois, l’appel 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 est FALSE.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.0 et versions ultérieures. |
| plateforme cible | Universel |
| d’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) |