NdisMCoSendNetBufferListsComplete 函数 (ndis.h)
NdisMCoSendNetBufferListsComplete 函数将 NET_BUFFER_LIST 结构的链接列表返回到过度分配的驱动程序,并返回 CoNDIS 发送请求的最终状态。
语法
void NdisMCoSendNetBufferListsComplete(
[in] IN NDIS_HANDLE NdisVcHandle,
[in] IN PNET_BUFFER_LIST NetBufferLists,
[in] IN ULONG SendCompleteFlags
);
参数
[in] NdisVcHandle
标识虚拟连接的句柄(VC)。 微型端口驱动程序获取此句柄作为其 MiniportCoCreateVc 函数的输入参数,无论是在客户端设置传出呼叫时,还是当调用管理器为客户端注册的服务访问点(SAP)创建 VC 以指示传入呼叫通知时。
[in] NetBufferLists
指向 NET_BUFFER_LIST 结构链接列表的指针。 微型端口驱动程序在之前对其调用中收到了NET_BUFFER_LIST结构 MiniportCoSendNetBufferLists 函数。
[in] SendCompleteFlags
可与按位 OR作组合的 NDIS 标志。 若要清除所有标志,请将此参数设置为零。 NdisMCoSendNetBufferListsComplete 支持NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL标志,如果已设置,则指示当前 IRQL DISPATCH_LEVEL。 有关此标志的详细信息,请参阅 调度 IRQL 跟踪。
返回值
没有
言论
微型端口驱动程序调用 NdisMCoSendNetBufferListsComplete 以完成 NDIS 向驱动程序发出的发送请求 MiniportCoSendNetBufferLists 函数。 微型端口驱动程序指定与已完成的发送请求关联的 NET_BUFFER_LIST 结构的链接列表。
当发送请求的状态处于挂起状态时,微型端口驱动程序将保留NET_BUFFER_LIST结构和与NET_BUFFER_LIST结构关联的所有资源的所有权。
微型端口驱动程序调用 NdisMCoSendNetBufferListsComplete后,NDIS 会将NET_BUFFER_LIST结构和关联数据返回到发起发送请求的过度驱动因素。
微型端口驱动程序可以按任意顺序完成发送请求。 例如,微型端口驱动程序可以从多个 MiniportCoSendNetBufferLists 连接NET_BUFFER_LIST结构列表, 调用或从 MiniportCoSendNetBufferLists 调用拆分列表。 但是,微型端口驱动程序不得修改与NET_BUFFER_LIST结构关联的NET_BUFFER结构列表。
微型端口驱动程序必须在 netBufferLists 参数指定的每个NET_BUFFER_LIST 结构 状态 成员中设置以下状态代码之一:
微型端口驱动程序调用 NdisMCoSendNetBufferListsComplete 不一定指示发送请求的数据已通过网络传输。 例如,数据可能在 NIC 硬件中排队。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_MCO_Function(ndis) |