PROTOCOL_CM_INCOMING_CALL_COMPLETE回调函数 (ndis.h)

  • 项目

ProtocolCmIncomingCallComplete 函数是必需的。 当 NDIS 调用此函数时， ProtocolCmIncomingCallComplete 会向调用管理器指示面向连接的客户端已完成对呼叫管理器以前通过调度的传入呼叫套餐的处理 NdisCmDispatchIncomingCall。

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

语法

PROTOCOL_CM_INCOMING_CALL_COMPLETE ProtocolCmIncomingCallComplete;

void ProtocolCmIncomingCallComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE CallMgrVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

参数

[in] Status

指示将传入调用调度到面向连接的客户端的操作的最终状态。

[in] CallMgrVcContext

指定调用管理器分配的上下文区域的句柄，调用管理器在其中维护其每 VC 状态。 调用管理器从其 ProtocolCoCreateVc 函数提供此句柄。

[in] CallParameters

指向调用 NdisCmDispatchIncomingCall 中由调用管理器指定的调用参数的指针。 信号协议确定调用管理器可以更改的调用参数（如果有）。

返回值

无

备注

当面向连接的客户端已完成调用管理器调度到它的传入连接套餐的处理后，如果 NdisCmDispatchIncomingCall 返回NDIS_STATUS_PENDING，则将调用此例程。 传入呼叫的最终状态位于 “状态”中。 Status 的可能值包括但不限于：

如果客户端接受传入呼叫，呼叫管理器应 () 发送信号消息，以向调用实体指示已接受呼叫。 如果客户端不接受呼叫，呼叫管理器应 () 发送信号消息，以指示该呼叫已被拒绝。

示例

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

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

PROTOCOL_CM_INCOMING_CALL_COMPLETE MyCmIncomingCallComplete;

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

_Use_decl_annotations_
VOID
 MyCmIncomingCallComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  CallMgrVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

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

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

要求

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

另请参阅

NdisCmDispatchIncomingCall

ProtocolClIncomingCall

ProtocolCmRegisterSap