W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER回调函数 (ndischimney.h)

项目
08/07/2023

[TCP 烟囱卸载功能已弃用，不应使用。]

NDIS 调用 MiniportTcpOffloadReceiveReturn 函数，将 NET_BUFFER_LIST 和相关结构的所有权返回到卸载目标。

语法

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

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

参数

[in] MiniportAdapterContext

卸载目标分配的上下文区域的句柄，卸载目标在其中维护有关此适配器实例的状态信息。微型端口驱动程序在调用 NDIS 时向 NDIS 提供了此句柄 NdisMSetMiniportAttributes 从其 MiniportInitializeEx 函数。

[in] NetBufferList

指向 NET_BUFFER_LIST 结构的指针。此结构可以是独立结构，也可以是NET_BUFFER_LIST结构链接列表中的第一个结构。链接列表可以包含NET_BUFFER_LIST结构，这些结构来自对的一个或多个调用 NdisTcpOffloadReceiveHandler 函数。

返回值

MiniportTcpOffloadReceiveReturn 函数应始终成功。因此， MiniportTcpOffloadReceiveReturn 函数应始终返回NDIS_STATUS_SUCCESS。

注解

NDIS 调用 MiniportTcpOffloadReceiveReturn 函数，以返回卸载目标在一个或多个先前调用中传递给的NET_BUFFER_LIST结构和关联结构的所有权 NdisTcpOffloadReceiveHandler 函数。

MiniportTcpOffloadReceiveReturn 函数可以准备返回的NET_BUFFER_LIST结构，以便在后续接收指示中使用。例如，尽管 MiniportTcpOffloadReceiveReturn 函数可以将NET_BUFFER_LIST结构返回到池 (，但它可以) 调用 NdisFreeNetBufferList 函数，但重用结构而不将其返回到池会更有效。

请注意，卸载目标驱动程序不应卸载，在返回所有指示的接收缓冲区之前，不得关闭卸载目标适配器。