NdisFSendNetBufferLists 函数（ndis.h）

项目
02/07/2025

筛选器驱动程序调用 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

指定当前 IRQL DISPATCH_LEVEL。有关此标志的详细信息，请参阅调度 IRQL 跟踪。

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 结构链接列表中的每个数据包使用相同的源端口，则扩展应在完成发送请求时 SendCompleteFlags 参数中设置 NDIS_SEND_COMPLETE_FLAGS_SWITCH_SINGLE_SOURCE 标志 NdisFSendNetBufferListsComplete。

注意此标志在 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 之前分配结构，然后在发送作完成后释放它们。

筛选器驱动程序必须设置 SourceHandle 每个 NET_BUFFER_LIST 结构的成员，该结构源自其传递给 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）
库	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI 符合性规则	Irql_Filter_Driver_Function（ndis）