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。 有关此标志的详细信息,请参阅 调度 IRQL 跟踪

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结构:

协议驱动程序可以在 DriverEntry 例程中预先分配NET_BUFFER_LIST结构。 或者,协议驱动程序可以在调用 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)
Ndis.lib
IRQL <=DISPATCH_LEVEL
DDI 符合性规则 Irql_Connection_Function(ndis)

另请参阅

DriverEntry

MiniportCoSendNetBufferLists

NET_BUFFER

NET_BUFFER_LIST

NET_BUFFER_LIST_INFO

NdisAllocateCloneNetBufferList NdisAllocateNetBufferAndNetBufferList

NdisAllocateNetBufferList

NdisMCoSendNetBufferListsComplete ProtocolCoSendNetBufferListsComplete