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) |