PROTOCOL_CL_CALL_CONNECTED回调函数 (ndis.h)

项目
02/26/2024

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的信息，请参阅批注函数行为。

要求

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