Funzione NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)

Chiamare la funzione NdisAdvanceNetBufferListDataStart per rilasciare lo spazio dati richiesto nelle chiamate precedenti a Funzione NdisRetreatNetBufferListDataStart .

Sintassi

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

Parametri

[in] NetBufferList

Puntatore a una struttura NET_BUFFER_LIST allocata in precedenza.

[in] DataOffsetDelta

Quantità di spazio dati usato da rilasciare.

[in] FreeMdl

Se la memoria allocata è TRUE e NDIS per soddisfare la chiamata NdisRetreatNetBufferListDataStart corrispondente, questa funzione libera la memoria allocata e l'MDL associato.

FreeMdlMdlHandler

Punto di ingresso facoltativo per una funzione NetFreeMdl . Se il chiamante specifica un punto di ingresso per la funzione NetFreeMdl , NDIS chiama NetFreeMdl per liberare un MDL e una memoria.

Valore restituito

nessuno

Osservazioni

NdisAdvanceNetBufferListDataStartrilascia lo spazio dati usato per tutte le strutture NET_BUFFER in una struttura NET_BUFFER_LIST . Se FreeMdl è TRUE eMemoria allocata NdisRetreatNetBufferListDataStart per soddisfare la richiesta di allocazione corrispondente,
NdisAdvanceNetBufferListDataStart libera la memoria allocata. La chiamata a questa funzione equivale alla chiamata NdisAdvanceNetBufferDataStart per ogni struttura NET_BUFFER nella struttura NET_BUFFER_LIST. Tuttavia, la chiamata a NdisAdvanceNetBufferListDataStart è più efficiente.

Quando i driver di protocollo chiamano NdisAdvanceNetBufferListDataStart nel percorso di ricezione per accedere alle varie intestazioni di trasporto, la catena MDL non deve essere modificata e FreeMdl è FALSE.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.0 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis/nblapi.h (include ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_NetBuffer_Function(ndis)

Vedi anche

NET_BUFFER

NET_BUFFER_LIST

NdisAdvanceNetBufferDataStart NdisRetreatNetBufferListDataStart

NetAllocateMdl

NetFreeMdl