Función NdisFSendNetBufferListsComplete (ndis.h)

Artículo
02/29/2024

Los controladores de filtro llaman a la función NdisFSendNetBufferListsComplete para devolver una lista vinculada de estructuras de NET_BUFFER_LIST a un controlador de sobreasignación 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 está 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 de Hyper-V.

Para obtener más información, vea Marcadores 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 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

None

Observaciones

Un controlador de filtro llama a la función NdisFSendNetBufferListsComplete para completar las solicitudes de envío 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 llamadas FilterSendNetBufferLists 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	Value
Cliente mínimo compatible	Se admite en 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)