NdisFReturnNetBufferLists 函数 (ndis.h)

项目
02/26/2024

筛选器驱动程序调用 NdisFReturnNetBufferLists 以释放一个或多个 NET_BUFFER_LIST 结构及其关联的 NET_BUFFER 结构的所有权。

语法

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

参数

[in] NdisFilterHandle

标识此筛选器模块的 NDIS 句柄。 NDIS 在对 FilterAttach 函数的调用中将句柄传递给筛选器驱动程序。

[in] NetBufferLists

指向要返回到基础驱动程序的NET_BUFFER_LIST结构链接列表的指针。链接列表可以包含以前对的多个调用NET_BUFFER_LIST结构 FilterReceiveNetBufferLists 函数。

[in] ReturnFlags

可与 OR 操作组合的 NDIS 标志。若要清除所有标志，请将此成员设置为零。此函数支持以下标志：

NDIS_RETURN_FLAGS_DISPATCH_LEVEL

指定当前 IRQL DISPATCH_LEVEL。有关此标志的详细信息，请参阅 Dispatch IRQL Tracking。

NDIS_RETURN_FLAGS_SWITCH_SINGLE_SOURCE

如果设置了此标志，则NET_BUFFER_LIST 结构的链接列表中的所有数据包都源自同一 Hyper-V 可扩展交换机源端口。

有关详细信息，请参阅 Hyper-V 可扩展交换机发送和接收标志。

注意如果NET_BUFFER_LIST结构链接列表中的每个数据包使用相同的源端口，则扩展应在发送请求时在 NdisFIndicateReceiveNetBufferLists 的 ReceiveFlags 参数中设置NDIS_RECEIVE_FLAGS_SWITCH_SINGLE_SOURCE标志。

返回值

无

备注

如果 NDIS 传递给的 ReceiveFlags 参数中NDIS_RECEIVE_FLAGS_RESOURCES标志 FilterReceiveNetBufferLists 函数未设置，筛选器驱动程序必须调用 NdisFReturnNetBufferLists 函数以返回 NET_BUFFER_LIST 结构和关联的数据。在筛选器驱动程序调用 NdisFReturnNetBufferLists 后，NDIS 将数据返回到基础驱动程序。

要求

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
目标平台	桌面
标头	ndis.h (包括 Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_Filter_Driver_Function (ndis)