NdisMCmDispatchIncomingCall 宏 (ndis.h)

NdisMCmDispatchIncomingCall 通知客户端对以前由该客户端向 MCM 驱动程序注册的 SAP 的传入调用。

语法

void NdisMCmDispatchIncomingCall(
  _SH_,
  _VH_,
  _CP_
);

参数

_SH_

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

_VH_

指定标识使用 NdisMCmCreateVc 创建的 VC 的句柄,当 MCM 驱动程序处理定向到此已注册 SAP 的传入调用产品/服务时,

_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

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 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)

另请参阅

CO_CALL_PARAMETERS

MiniportInterruptDPC

NdisClIncomingCallComplete

NdisClRegisterSap

NdisCmDispatchIncomingCall

NdisMCmActivateVc

NdisMCmCreateVc

NdisMCmDeactivateVc

NdisMCmDeleteVc

NdisMCmDispatchCallConnected

ProtocolClIncomingCall

ProtocolCmIncomingCallComplete

ProtocolCmRegisterSap