NdisSendNetBufferLists 函数 (ndis.h)
协议驱动程序调用 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) |