NdisMCmDispatchIncomingCall 宏 (ndis.h)

项目
08/07/2023

NdisMCmDispatchIncomingCall 通知客户端该客户端以前使用 MCM 驱动程序注册的 SAP 上的传入呼叫。

语法

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

参数

_SH_

指定标识 SAP 的句柄。当客户端最初调用 NdisClRegisterSap 并且 MCM 驱动程序获取此句柄作为其输入参数时，NDIS 会设置此句柄 ProtocolCmRegisterSap 函数。

_VH_

指定标识 VC 的句柄，当 MCM 驱动程序处理定向到此已注册 SAP 的传入呼叫套餐时，使用 NdisMCmCreateVc 创建。

_CP_

指向 CO_CALL_PARAMETERS 类型的结构的指针，该结构指定 VC 的调用和媒体参数。

返回值

无

备注

在调用 NdisMCmDispatchIncomingCall 之前，MCM 驱动程序已执行以下操作：

标识了以前由特定客户端注册的目标 SAP，该调用实际上 (通过网络接收) 建立连接的请求
使用 NdisMCmCreateVc 为传入呼叫创建了 VC
可能通过网络协商了可接受的调用参数，或接受了从远程节点发送的调用参数
已使用 NdisMCmActivateVc 激活 VC ，以通知 NDIS 它已准备好按照协商或接受的调用参数在 VC 上进行转移

MCM 驱动程序对 NdisMCmDispatchIncomingCall 的调用会导致 NDIS 调用客户端的 ProtocolClIncomingCall 函数，客户端在该函数中接受或拒绝请求的连接。在决定是否接受连接后，客户端调用 NdisClIncomingCallComplete，后者又调用 MCM 驱动程序的 ProtocolCmIncomingCallComplete 函数。如果客户端接受了调用，MCM 驱动程序接下来会调用 NdisMCmDispatchCallConnected。否则，它会在通知远程节点提供的呼叫被拒绝后，停用 (并可能删除它创建的 VC) 。

只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才调用 NdisMCmDispatchIncomingCall。独立调用管理器（将自己注册到 NDIS 作为协议驱动程序）改为调用 NdisCmDispatchIncomingCall 。

要求

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