Función NdisFReturnNetBufferLists (ndis.h)

Artículo
02/26/2024

Los controladores de filtro llaman a NdisFReturnNetBufferLists para liberar la propiedad de una o varias estructuras de NET_BUFFER_LIST y sus estructuras de NET_BUFFER asociadas.

Sintaxis

void NdisFReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisFilterHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

Parámetros

[in] NdisFilterHandle

Identificador NDIS que identifica este módulo de filtro. NDIS pasó el identificador al controlador de filtro en una llamada a la función FilterAttach .

[in] NetBufferLists

Puntero a una lista vinculada de estructuras de NET_BUFFER_LIST que se van a devolver al controlador subyacente. La lista vinculada puede contener estructuras de NET_BUFFER_LIST de varias llamadas anteriores a Función FilterReceiveNetBufferLists .

[in] ReturnFlags

Marcas NDIS que se pueden combinar con una operación OR. Para borrar todas las marcas, establezca este miembro en cero. Esta función admite las marcas siguientes:

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

Especifica que el IRQL actual está DISPATCH_LEVEL. Para obtener más información sobre esta marca, vea Dispatch IRQL Tracking.

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

Si se establece esta marca, todos los paquetes de una lista vinculada de NET_BUFFER_LIST estructuras originadas en el mismo puerto de origen de conmutador extensible de Hyper-V.

Para obtener más información, consulte Marcas de envío y recepción de conmutador extensible de Hyper-V.

Nota Si cada paquete de la lista vinculada de estructuras de NET_BUFFER_LIST usa el mismo puerto de origen, la extensión debe establecer la marca de NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE en el parámetro ReceiveFlags de NdisFIndicateReceiveNetBufferLists cuando envía la solicitud.

Valor devuelto

None

Observaciones

Si la marca de NDIS_RECEIVE_FLAGS_RESOURCES en el parámetro ReceiveFlags que NDIS pasó alNo se estableció la función FilterReceiveNetBufferLists, el controlador de filtro debe llamar a la función NdisFReturnNetBufferLists para devolver las estructuras de NET_BUFFER_LIST y los datos asociados. Después de que el controlador de filtro llame a NdisFReturnNetBufferLists, NDIS devuelve los datos al controlador subyacente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con NDIS 6.0 y versiones posteriores.
Plataforma de destino	Escritorio
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Filter_Driver_Function(ndis)