NdisCoSendNetBufferLists 函数 (ndis.h)

项目
08/07/2023

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)