PROTOCOL_CL_CALL_CONNECTED回调函数（ndis.h）

项目
02/07/2025

ProtocolClCallConnected 函数由接受传入调用的面向连接的 NDIS 客户端使用。此类客户端必须具有 ProtocolClCallConnected 函数。否则，此类协议驱动程序的注册 ProtocolClCallConnected 函数只需返回控制权。

注意必须使用 PROTOCOL_CL_CALL_CONNECTED 类型声明函数。有关详细信息，请参阅以下示例部分。

语法

PROTOCOL_CL_CALL_CONNECTED ProtocolClCallConnected;

void ProtocolClCallConnected(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

参数

[in] ProtocolVcContext

指定客户端的每个 VC 上下文区域的句柄。客户端最初从其 ProtocolCoCreateVc 函数将此句柄返回到 NDIS。

返回值

没有

言论

调用 ProtocolClCallConnected 时，调用管理器已成功在客户端的 ProtocolClIncomingCall 函数接受的传入呼叫套餐上成功完成最终握手，该函数已在 ProtocolVcContext 设置此连接的调用参数。

调用 ProtocolClCallConnected 表示，数据传输（无论是传入还是传出）现在可以在 VC 上完成。 ProtocolClCallConnected 应确保客户端准备好在 VC 上发出或接受传输，然后再返回控制权。

示例

若要定义 ProtocolClCallConnected 函数，必须先提供一个函数声明来标识要定义的函数的类型。 Windows 为驱动程序提供了一组函数类型。使用函数类型声明函数有助于驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。

例如，若要定义名为“MyClCallConnected”的 ProtocolClCallConnected 函数，请使用 PROTOCOL_CL_CALL_CONNECTED 类型，如以下代码示例所示：

PROTOCOL_CL_CALL_CONNECTED MyClCallConnected;

然后，按如下所示实现函数：

_Use_decl_annotations_
VOID
 MyClCallConnected(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

PROTOCOL_CL_CALL_CONNECTED 函数类型在 Ndis.h 头文件中定义。若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 PROTOCOL_CL_CALL_CONNECTED 函数类型的批注。有关函数声明要求的详细信息，请参阅使用 NDIS 驱动程序的函数角色类型声明函数。

有关 Use_decl_annotations的信息，请参阅批注函数行为。

要求

要求	价值
最低支持的客户端	Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序（请参阅 ProtocolClCallConnected （NDIS 5.1）。支持 NDIS 5.1 驱动程序（请参阅 Windows XP 中的 ProtocolClCallConnected （NDIS 5.1）。
目标平台	窗户
标头	ndis.h （包括 Ndis.h）
IRQL	<= DISPATCH_LEVEL