NdisSendNetBufferLists 函数 (ndis.h)

项目
02/29/2024

协议驱动程序调用 NdisSendNetBufferLists 函数以发送包含在NET_BUFFER_LIST 结构列表中的网络数据。

语法

void NdisSendNetBufferLists(
  [in] NDIS_HANDLE                       NdisBindingHandle,
  [in] __drv_aliasesMem PNET_BUFFER_LIST NetBufferLists,
  [in] NDIS_PORT_NUMBER                  PortNumber,
  [in] ULONG                             SendFlags
);

参数

[in] NdisBindingHandle

标识目标适配器的句柄。先前对 NdisOpenAdapterEx 的调用返回了此句柄。

[in] NetBufferLists

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

[in] PortNumber

标识微型端口适配器端口的端口号。微型端口适配器的默认端口号为零。不使用微型端口适配器端口的协议驱动程序应指定默认端口。

[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结构，这些结构与过度的驱动程序的条件匹配。此标志对检查环回或循环回其他绑定没有影响。

返回值

无

备注

协议驱动程序调用 NdisSendNetBufferLists 后，NDIS 将 NET_BUFFER_LIST 结构提交到基础驱动程序的 MiniportSendNetBufferLists 函数。

协议驱动程序必须通过调用以下函数之一从池中分配每个NET_BUFFER_LIST结构：

协议驱动程序可以预先分配NET_BUFFER_LIST结构，例如，在其 DriverEntry 例程中。或者，驱动程序可以在调用 NdisSendNetBufferLists 之前分配结构，然后在发送操作完成时释放这些结构。当 NDIS 将NET_BUFFER_LIST结构返回到 ProtocolSendNetBufferListsComplete，微型端口驱动程序可以准备NET_BUFFER_LIST结构和任何关联的资源以供重复使用。重用NET_BUFFER_LIST结构可以产生更好的性能，而不是将结构返回到池，然后将其重新分配为另一个发送操作。

协议驱动程序必须将每个 NET_BUFFER_LIST 结构的 SourceHandle 成员设置为它传递给 NdisBindingHandle 参数的相同值。绑定句柄提供 NDIS 在基础微型端口驱动程序调用后将NET_BUFFER_LIST结构返回到协议驱动程序所需的信息 NdisMSendNetBufferListsComplete。

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

在协议驱动程序使用NET_BUFFER_LIST结构列表调用 NdisSendNetBufferLists 之前，协议驱动程序必须确保NET_BUFFER_LIST结构按应通过网络发送的顺序进行设置。

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

在 NDIS 调用 ProtocolSendNetBufferListsComplete 之前，协议驱动程序发起的发送的当前状态对协议驱动程序不可用。协议驱动程序在调用 NdisSendNetBufferLists 时暂时释放为发送请求分配的所有资源的所有权。在调用 NdisSendNetBufferLists 后，协议驱动程序不应尝试检查NET_BUFFER_LIST结构或任何关联数据。

要求

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