NdisFSendNetBufferListsComplete 函数 (ndis.h)

项目
08/07/2023

筛选器驱动程序调用 NdisFSendNetBufferListsComplete 函数，以将 NET_BUFFER_LIST 结构的链接列表返回到过度分配的驱动程序，并返回发送请求的最终状态。

语法

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

参数

[in] NdisFilterHandle

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

NetBufferList

指向 NET_BUFFER_LIST 结构链接列表的指针。筛选器驱动程序在之前对的调用中收到了 NET_BUFFER_LIST 结构 FilterSendNetBufferLists 函数。

[in] SendCompleteFlags

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

NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE

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

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

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

注意此标志在 NDIS 6.30 及更高版本中可用。

返回值

无

备注

筛选器驱动程序调用 NdisFSendNetBufferListsComplete 函数以完成 NDIS 对驱动程序发出的请求的发送 FilterSendNetBufferLists 函数。筛选器驱动程序指定与已完成的发送请求关联的 NET_BUFFER_LIST 结构的链接列表。当发送请求的状态处于挂起状态时，筛选器驱动程序将保留 NET_BUFFER_LIST 结构和与 NET_BUFFER_LIST 结构关联的所有资源的所有权。

筛选器驱动程序可以按任何顺序完成发送请求。例如，筛选器驱动程序可以从多个 FilterSendNetBufferLists 调用连接NET_BUFFER_LIST结构列表，或者从 FilterSendNetBufferLists 调用拆分列表。但是，筛选器驱动程序不得修改与NET_BUFFER_LIST 结构关联的 NET_BUFFER 结构的列表。

注意筛选器驱动程序应跟踪它源自的发送请求，并确保它不会调用此类请求完成时，NdisFSendNetBufferListsComplete 函数。

要求

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