PROTOCOL_SEND_NET_BUFFER_LISTS_COMPLETE回调函数 （ndis.h）
ProtocolSendNetBufferListsComplete 函数完成协议驱动程序通过调用发起的发送作 NdisSendNetBufferLists 函数。
语法
PROTOCOL_SEND_NET_BUFFER_LISTS_COMPLETE ProtocolSendNetBufferListsComplete;
void ProtocolSendNetBufferListsComplete(
[in] NDIS_HANDLE ProtocolBindingContext,
[in] PNET_BUFFER_LIST NetBufferList,
[in] ULONG SendCompleteFlags
)
{...}
参数
[in] ProtocolBindingContext
协议驱动程序分配的上下文区域的句柄，用于维护有关绑定的状态信息。 在上一次调用 NdisOpenAdapterEx时，此句柄已传递到 NDIS。
[in] NetBufferList
指向协议驱动程序在上一次调用 NdisSendNetBufferLists中提供的 NET_BUFFER_LIST 结构列表的指针。
[in] SendCompleteFlags
可与 OR作结合使用的 NDIS 标志。 若要清除所有标志，请将此成员设置为零。 此函数支持NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL标志;如果已设置，则指示当前 IRQL DISPATCH_LEVEL。 有关此标志的详细信息，请参阅 调度 IRQL 跟踪。
返回值
没有
言论
ProtocolSendNetBufferListsComplete 是协议驱动程序的必需函数。 ProtocolSendNetBufferListsComplete 执行完成发送作所需的任何后处理。 例如，协议驱动程序可以通知客户端请求协议发送发送作已完成的网络数据。
基础微型端口驱动程序调用 ProtocolSendNetBufferListsComplete NdisMSendNetBufferListsComplete 函数。 完成发送作通常意味着基础微型端口驱动程序已传输指定的网络数据。 但是，微型端口驱动程序可以指示发送作在将网络数据传输到其 NIC 后就已完成。
当 NDIS 调用 ProtocolSendNetBufferListsComplete时，协议驱动程序将重新获得与 NetBufferLists 参数指定的 NET_BUFFER_LIST 结构关联的所有资源的所有权。
NDIS 始终按照协议确定的顺序将协议提供的网络数据提交到基础微型端口驱动程序，如传递给 NdisSendNetBufferLists。 但是，基础驱动程序可以按任意顺序完成发送请求。 也就是说，协议驱动程序可以依赖于 NDIS 以 FIFO 将网络数据提交到基础驱动程序。 但是，协议驱动程序不能依赖基础驱动程序以相同的顺序调用 NdisMSendNetBufferListsComplete。
NDIS 在 IRQL<= DISPATCH_LEVEL 调用 ProtocolSendNetBufferListsComplete。
示例
若要定义 ProtocolSendNetBufferListsComplete 函数，必须先提供一个函数声明来标识要定义的函数类型。 Windows 为驱动程序提供了一组函数类型。 使用函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。例如，若要定义名为“MySendNetBufferListsComplete”的 ProtocolSendNetBufferListsComplete 函数，请使用 PROTOCOL_SEND_NET_BUFFER_LISTS_COMPLETE 类型，如以下代码示例所示：
PROTOCOL_SEND_NET_BUFFER_LISTS_COMPLETE MySendNetBufferListsComplete;
然后，按如下所示实现函数：
_Use_decl_annotations_
VOID
MySendNetBufferListsComplete(
NDIS_HANDLE ProtocolBindingContext,
PNET_BUFFER_LIST NetBufferLists,
ULONG SendCompleteFlags
)
{...}
PROTOCOL_SEND_NET_BUFFER_LISTS_COMPLETE 函数类型在 Ndis.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 PROTOCOL_SEND_NET_BUFFER_LISTS_COMPLETE 函数类型的批注。 有关函数声明要求的详细信息，请参阅 使用 NDIS 驱动程序的函数角色类型声明函数。
有关 Use_decl_annotations的信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | NDIS 6.0 及更高版本中受支持。 |
| 目标平台 | 窗户 |
| 标头 | ndis.h （包括 Ndis.h） |
| IRQL | <= DISPATCH_LEVEL |