NdisFSendNetBufferLists 函数 (ndis.h)

项目
08/07/2023

筛选器驱动程序调用 NdisFSendNetBufferLists 函数来发送网络数据缓冲区列表。

语法

void NdisFSendNetBufferLists(
  [in] NDIS_HANDLE                       NdisFilterHandle,
       __drv_aliasesMem PNET_BUFFER_LIST NetBufferList,
  [in] NDIS_PORT_NUMBER                  PortNumber,
  [in] ULONG                             SendFlags
);

参数

[in] NdisFilterHandle

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

NetBufferList

指向 NET_BUFFER_LIST 结构链接列表的指针。每个 NET_BUFFER_LIST 结构都描述 NET_BUFFER 结构的列表。

[in] PortNumber

标识微型端口适配器端口的端口号。微型端口适配器端口号是通过调用 NdisMAllocatePort 函数分配的。零值标识微型端口适配器的默认端口。

[in] SendFlags

定义发送操作的属性的标志。标志可以与 OR 操作结合使用。若要清除所有标志，请将此成员设置为零。此函数支持以下标志：

NDIS_SEND_FLAGS_DISPATCH_LEVEL

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

NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK

指定 NDIS 应检查环回。默认情况下，NDIS 不会将数据循环回提交发送请求的驱动程序。过度使用的驱动程序可以通过设置此标志来替代此行为。设置此标志后，NDIS 将标识包含与绑定的接收条件匹配的所有 NET_BUFFER 结构。 NDIS 指示NET_BUFFER结构，这些结构与过度的驱动程序的条件匹配。此标志不会影响检查其他绑定上的环回或循环回。

NDIS_SEND_FLAGS_SWITCH_SINGLE_SOURCE

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

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

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

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

NDIS_SEND_FLAGS_SWITCH_DESTINATION_GROUP

如果设置了此标志，则 NET_BUFFER_LIST 结构链接列表中的所有数据包都将转发到同一可扩展交换机目标端口。

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

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

返回值

无

备注

筛选器驱动程序调用 NdisFSendNetBufferLists 函数后，NDIS 将 NET_BUFFER_LIST 结构提交到基础驱动程序。

筛选器驱动程序可以源自发送请求，也可以筛选它从过度覆盖的驱动程序接收的请求。如果筛选器驱动程序源自发送请求，则驱动程序必须分配缓冲区池。筛选器驱动程序从池中分配每个 NET_BUFFER_LIST 结构。

筛选器驱动程序可以预分配 NET_BUFFER_LIST 结构，也可以在调用 NdisFSendNetBufferLists 之前分配结构，然后在发送操作完成时释放这些结构。

筛选器驱动程序必须将它源自的每个NET_BUFFER_LIST结构的 SourceHandle 成员设置为它传递给 NdisFilterHandle 参数的相同值。筛选器句柄提供 NDIS 将 NET_BUFFER_LIST 结构返回到筛选器驱动程序所需的信息。筛选器驱动程序不得修改其未源自的任何NET_BUFFER_LIST结构中的 SourceHandle 成员。

在调用 NdisFSendNetBufferLists 之前，筛选器驱动程序可以设置随 NET_BUFFER_LIST_INFO宏一起发送请求的信息。基础驱动程序可以使用 NET_BUFFER_LIST_INFO 宏检索此信息。

NDIS 调用筛选器驱动程序的 FilterSendNetBufferLists 函数，用于传递来自过度驱动程序的发送请求。筛选器驱动程序可以通过将 FilterSendNetBufferLists 中收到的NET_BUFFER_LISTT 结构传递给 NdisFSendNetBufferLists 来传递此类请求。

筛选器驱动程序一旦调用 NdisFSendNetBufferLists 函数，就会放弃 NET_BUFFER_LIST 结构和所有相关资源的所有权。 NDIS 调用 FilterSendNetBufferListsComplete 函数，用于将结构和数据返回到筛选器驱动程序。在将列表传递给 FilterSendNetBufferListsComplete 之前，NDIS 可以将多个发送请求中的结构和数据收集到NET_BUFFER_LIST结构的单个链接列表中。

在 NDIS 调用 FilterSendNetBufferListsComplete 之前，发送请求的当前状态对筛选器驱动程序不可用。筛选器驱动程序在调用 NdisFSendNetBufferLists 时暂时释放与发送请求关联的所有资源的所有权。在调用 NdisFSendNetBufferLists 后，筛选器驱动程序不应尝试检查NET_BUFFER_LIST结构或任何关联的数据。

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

要求

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