Función NdisFSendNetBufferListsComplete (ndis.h)

Artículo
02/07/2025

Los controladores de filtro llaman a la función NdisFSendNetBufferListsComplete para devolver una lista vinculada de estructuras de NET_BUFFER_LIST a un controlador que supera el límite y devolver el estado final de una solicitud de envío.

Sintaxis

void NdisFSendNetBufferListsComplete(
  [in] NDIS_HANDLE      NdisFilterHandle,
       PNET_BUFFER_LIST NetBufferList,
  [in] ULONG            SendCompleteFlags
);

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 .

NetBufferList

Puntero a una lista vinculada de estructuras de NET_BUFFER_LIST. El controlador de filtro recibió las estructuras de NET_BUFFER_LIST en las llamadas anteriores a . función FilterSendNetBufferLists.

[in] SendCompleteFlags

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_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_COMPLETE_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 Hyper-V.

Para obtener más información, vea Hyper-V extensible Switch Send and Receive Flags.

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

Nota Esta marca está disponible en NDIS 6.30 y versiones posteriores.

Valor devuelto

Ninguno

Observaciones

Un controlador de filtro llama a la función NdisFSendNetBufferListsComplete para completar las solicitudes realizadas por NDIS al controlador. función FilterSendNetBufferLists. El controlador de filtro especifica una lista vinculada de estructuras de NET_BUFFER_LIST asociadas a las solicitudes de envío completadas. Aunque el estado de las solicitudes de envío está pendiente, el controlador de filtro conserva la propiedad de las estructuras de NET_BUFFER_LIST y todos los recursos asociados a las estructuras de NET_BUFFER_LIST.

El controlador de filtro puede completar las solicitudes de envío en cualquier orden. Por ejemplo, el controlador de filtro podría concatenar las listas de estructura de NET_BUFFER_LIST de varias FilterSendNetBufferLists llamadas o dividir una lista de una llamada FilterSendNetBufferLists. Sin embargo, el controlador de filtro no debe modificar la lista de estructuras de NET_BUFFER asociadas a una estructura de NET_BUFFER_LIST.

Nota Un controlador de filtro debe realizar un seguimiento de las solicitudes de envío que origina y asegurarse de que no llama a . función NdisFSendNetBufferListsComplete cuando se completan dichas solicitudes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Se admite en NDIS 6.0 y versiones posteriores.
de la plataforma de destino de	Escritorio
encabezado de	ndis.h (incluya Ndis.h)
biblioteca de	Ndis.lib
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	Irql_Filter_Driver_Function(ndis)