Funzione NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)
Chiamare la funzione di 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 usato spazio dati da rilasciare.
[in] FreeMdl
Se TRUE e la memoria allocata NDIS per soddisfare il corrispondente NdisRetreatNetBufferListDataStart chiamata, questa funzione libera la memoria allocata e l'MDL associato.
FreeMdlMdlHandler
Punto di ingresso facoltativo per una funzione di 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
NdisAdvanceNetBufferListDataStart rilascia usato spazio dati per tutte le strutture NET_BUFFER in una struttura NET_BUFFER_LIST. Se FreeMdl è true e
NdisRetreatNetBufferListDataStart memoria allocata 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 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.
Fabbisogno
| 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) |