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) 。 当客户端设置传出呼叫或调用管理器为客户端注册的服务访问点创建 VC 时,微型端口驱动程序获取此句柄作为其 MiniportCoCreateVc 函数的输入参数, (SAP) 指示传入呼叫通知。
[in] NetBufferLists
指向NET_BUFFER_LIST结构链接列表 的 指针。 微型端口驱动程序在之前对其的调用中收到了NET_BUFFER_LIST结构 MiniportCoSendNetBufferLists 函数。
[in] SendCompleteFlags
可与按位 OR 运算组合的 NDIS 标志。 若要清除所有标志,请将此参数设置为零。 NdisMCoSendNetBufferListsComplete 支持 NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL 标志,该标志;如果设置,则指示当前 IRQL 已DISPATCH_LEVEL。 有关此标志的详细信息,请参阅 Dispatch IRQL Tracking。
返回值
无
备注
微型端口驱动程序调用 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结构的 Status 成员中设置以下状态代码之一:
微型端口驱动程序对 NdisMCoSendNetBufferListsComplete 的调用不一定指示发送请求的数据已通过网络传输。 例如,数据可能在 NIC 硬件中排队。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 NDIS 6.0 及更高版本中受支持。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
Library | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_MCO_Function (ndis) |