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
指定当前 IRQL DISPATCH_LEVEL。 有关此标志的详细信息，请参阅 调度 IRQL 跟踪。
NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK
指定 NDIS 应检查环回。 默认情况下，NDIS 不会环回提交发送请求的驱动程序的数据。 过度的驱动程序可以通过设置此标志来替代此行为。 设置此标志后，NDIS 会标识包含与绑定接收条件匹配的数据的所有NET_BUFFER结构。 NDIS 指示NET_BUFFER结构，这些结构与过度部署的驱动程序匹配。 此标志对检查环回或其他绑定没有影响。
返回值
没有
言论
协议驱动程序调用 NdisSendNetBufferLists后，NDIS 会将 NET_BUFFER_LIST 结构提交到基础驱动程序的 MiniportSendNetBufferLists 函数。
协议驱动程序必须通过调用以下函数之一从池中分配每个NET_BUFFER_LIST结构：
协议驱动程序可以在 DriverEntry 例程中预先分配NET_BUFFER_LIST结构。 或者，驱动程序可以在调用 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） |
| 库 | Ndis.lib |
| IRQL | <=DISPATCH_LEVEL |
| DDI 符合性规则 | Irql_SendRcv_Function（ndis） |