W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER función de devolución de llamada (ndischimney.h)

Artículo
08/07/2023

[La característica de descarga de chimenea TCP está en desuso y no se debe usar.]

NDIS llama a la función MiniportTcpOffloadReceiveReturn para devolver la propiedad de NET_BUFFER_LIST y las estructuras asociadas a un destino de descarga.

Sintaxis

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parámetros

[in] MiniportAdapterContext

Identificador de un área de contexto asignada de destino de descarga en la que el destino de descarga mantiene información de estado sobre esta instancia del adaptador. El controlador de minipuerto proporcionó este identificador a NDIS cuando llamó NdisMSetMiniportAttributes de su Función MiniportInitializeEx .

[in] NetBufferList

Puntero a una estructura de NET_BUFFER_LIST . Esta estructura puede ser una estructura independiente o la primera estructura de una lista vinculada de estructuras de NET_BUFFER_LIST. La lista vinculada puede contener estructuras de NET_BUFFER_LIST de una o varias llamadas a . Función NdisTcpOffloadReceiveHandler .

Valor devuelto

La función MiniportTcpOffloadReceiveReturn siempre debe realizarse correctamente. Por lo tanto, la función MiniportTcpOffloadReceiveReturn siempre debe devolver NDIS_STATUS_SUCCESS.

Comentarios

NDIS llama a la función MiniportTcpOffloadReceiveReturn para devolver la propiedad de NET_BUFFER_LIST estructuras y estructuras asociadas que el destino de descarga pasó en una o varias llamadas anteriores a la Función NdisTcpOffloadReceiveHandler .

La función MiniportTcpOffloadReceiveReturn puede preparar una estructura de NET_BUFFER_LIST devuelta para su uso en una indicación de recepción posterior. Aunque la función MiniportTcpOffloadReceiveReturn puede devolver las estructuras de NET_BUFFER_LIST a un grupo (por ejemplo, podría llamar a la función NdisFreeNetBufferList ), puede ser más eficaz reutilizar las estructuras sin devolverlas al grupo.

Tenga en cuenta que el controlador de destino de descarga no debe descargarse y el adaptador de destino de descarga no debe cerrarse hasta que se hayan devuelto todos los búferes de recepción indicados.