Función NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)
Llame a la función NdisAdvanceNetBufferListDataStart para liberar el espacio de datos que se afirmó en las llamadas anteriores a . Función NdisRetreatNetBufferListDataStart .
Sintaxis
NDIS_EXPORTED_ROUTINE VOID NdisAdvanceNetBufferListDataStart(
[in] NET_BUFFER_LIST *NetBufferList,
[in] ULONG DataOffsetDelta,
[in] BOOLEAN FreeMdl,
NET_BUFFER_FREE_MDL *FreeMdlMdlHandler
);
Parámetros
[in] NetBufferList
Puntero a una estructura de NET_BUFFER_LIST asignada previamente.
[in] DataOffsetDelta
Cantidad de espacio de datos usado que se va a liberar.
[in] FreeMdl
Si TRUE y NDIS asignan memoria para satisfacer la llamada correspondiente a NdisRetreatNetBufferListDataStart , esta función libera la memoria asignada y la MDL asociada.
FreeMdlMdlHandler
Un punto de entrada opcional para una función NetFreeMdl . Si el autor de la llamada especifica un punto de entrada para la función NetFreeMdl , NDIS llama a NetFreeMdl para liberar una MDL y memoria.
Valor devuelto
None
Observaciones
Las versiones de NdisAdvanceNetBufferListDataStartusan espacio de datos para todas las estructuras de NET_BUFFER de una estructura de NET_BUFFER_LIST . Si FreeMdl es TRUE y NdisRetreatNetBufferListDataStart asignó memoria para satisfacer la solicitud de asignación correspondiente,
NdisAdvanceNetBufferListDataStart libera la memoria asignada. Llamar a esta función equivale a llamar a NdisAdvanceNetBufferDataStart para cada estructura de NET_BUFFER en la estructura NET_BUFFER_LIST.
Sin embargo, llamar a NdisAdvanceNetBufferListDataStart es más eficaz.
Cuando los controladores de protocolo llaman a NdisAdvanceNetBufferListDataStart en la ruta de acceso de recepción para acceder a los distintos encabezados de transporte, la cadena MDL no debe modificarse y FreeMdl es FALSE.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con NDIS 6.0 y versiones posteriores. |
| Plataforma de destino | Universal |
| Encabezado | ndis/nblapi.h (include ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | Irql_NetBuffer_Function(ndis) |