NdisCoSendNetBufferLists 函数 (ndis.h)
NdisCoSendNetBufferLists 函数发送包含在指定NET_BUFFER_LIST结构列表中的网络数据。
语法
void NdisCoSendNetBufferLists(
[in] NDIS_HANDLE NdisVcHandle,
[in] PNET_BUFFER_LIST NetBufferLists,
[in] ULONG SendFlags
);
参数
[in] NdisVcHandle
虚拟连接的句柄 (标识发送请求目标的 VC) 。
[in] NetBufferLists
指向NET_BUFFER_LIST结构链接列表 的 指针。 每个NET_BUFFER_LIST结构描述 NET_BUFFER 结构的列表。
[in] SendFlags
定义发送操作的属性的标志。 标志可以与按位 OR 运算结合使用。 若要清除所有标志，请将此参数设置为零。 NdisCoSendNetBufferLists 支持以下标志：
NDIS_SEND_FLAGS_DISPATCH_LEVEL
当前 IRQL 已DISPATCH_LEVEL。 有关此标志的详细信息，请参阅 Dispatch IRQL Tracking。
NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK
NDIS 应检查环回。 默认情况下，NDIS 不会将数据循环回提交发送请求的驱动程序。 过度覆盖的驱动程序可以通过设置NDIS_SEND_FLAGS_CHECK_FOR_LOOPBACK来替代此行为。 设置此标志后，NDIS 将标识包含与绑定的接收条件匹配的所有NET_BUFFER结构。 NDIS 指示NET_BUFFER结构，这些结构与超载驱动程序的条件匹配。 此标志不会影响检查其他绑定上的环回或环回。
返回值
无
备注
CoNDIS 协议驱动程序调用 NdisCoSendNetBufferLists 后，NDIS 将 NetBufferLists 参数指定的NET_BUFFER_LIST结构提交到基础驱动程序的 MiniportCoSendNetBufferLists 函数。
协议驱动程序必须通过调用以下函数之一从池中分配每个NET_BUFFER_LIST结构：
协议驱动程序可以预先分配NET_BUFFER_LIST结构，例如在其 DriverEntry 例程中。 或者，协议驱动程序可以在调用 NdisCoSendNetBufferLists 之前立即分配结构，然后在发送操作完成时释放它们。 当 NDIS 将NET_BUFFER_LIST结构返回到 ProtocolCoSendNetBufferListsComplete 函数，协议驱动程序可以准备NET_BUFFER_LIST结构和任何关联的资源以供重复使用。 如果重复使用NET_BUFFER_LIST结构，则可以获得比将结构返回到池，然后将其重新分配用于另一个发送操作更好的性能。协议驱动程序必须将每个NET_BUFFER_LIST结构的 SourceHandle 成员设置为它在 NdisVcHandle 参数中传递的相同值。 源句柄提供 NDIS 在基础微型端口驱动程序调用 后将NET_BUFFER_LIST结构返回到协议驱动程序所需的信息 NdisMCoSendNetBufferListsComplete 函数。
在协议驱动程序调用 NdisCoSendNetBufferLists 之前，驱动程序可以设置随 NET_BUFFER_LIST_INFO 宏一起发送请求的信息。 基础驱动程序可以使用 NET_BUFFER_LIST_INFO 宏检索此信息。
在协议驱动程序使用NET_BUFFER_LIST结构列表调用 NdisCoSendNetBufferLists 之前，协议驱动程序必须确保按照网络数据的发送顺序设置NET_BUFFER_LIST结构。
一旦协议驱动程序调用 NdisCoSendNetBufferLists，它就不再拥有NET_BUFFER_LIST结构和所有关联的资源。 NDIS 调用 ProtocolCoSendNetBufferListsComplete 函数将结构和数据返回到协议驱动程序。 在将列表传递给 ProtocolCoSendNetBufferListsComplete 之前，NDIS 可以将多个发送请求中的结构和数据收集到NET_BUFFER_LIST结构的单个链接列表中。
在 NDIS 调用 ProtocolCoSendNetBufferListsComplete 之前，协议驱动程序发起的发送的当前状态对协议驱动程序不可用。 协议驱动程序在调用 NdisCoSendNetBufferLists 时暂时释放为发送请求分配的所有资源的所有权。 在驱动程序调用 NdisCoSendNetBufferLists 后，协议驱动程序绝不应尝试检查NET_BUFFER_LIST结构或任何关联的数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 支持 Windows Vista 中的 NDIS 6.0 驱动程序。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h (包括 Ndis.h) |
| Library | Ndis.lib |
| IRQL | <=DISPATCH_LEVEL |
| DDI 符合性规则 | Irql_Connection_Function (ndis) |