Función NdisAdvanceNetBufferListDataStart (ndis/nblapi.h)

Artículo
08/07/2023

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)