NdisCmMakeCallComplete 函数 (ndis.h)

项目
08/07/2023

NdisCmMakeCallComplete 返回客户端请求的最终状态，调用管理器之前NDIS_STATUS_PENDING返回请求进行传出呼叫。

语法

void NdisCmMakeCallComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisVcHandle,
  [in, optional] NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

参数

[in] Status

指定尝试建立连接的最终状态，NDIS_STATUS_SUCCESS或任何 CM 确定NDIS_STATUS_ XXX （NDIS_STATUS_PENDING除外）。

[in] NdisVcHandle

指定客户端创建的 VC 的句柄，调用管理器最初作为其 ProtocolCoCreateVc 函数的输入参数获取。最近，CM 从传递给其 ProtocolCmMakeCall 函数的 CallMgrVcContext 指定的每个 VC 状态获取此句柄。

[in, optional] NdisPartyHandle

指定客户端创建的多点 VC 上初始方的句柄，调用管理器作为 其 ProtocolCmMakeCall 函数的输入参数获取该句柄。如果给定的 NdisVcHandle 表示点到点 VC，则此参数为 NULL。

[in, optional] CallMgrPartyContext

指定调用方分配的常驻上下文区域的 CM 提供的句柄，其中 CM 将维护每方状态信息;如果 NdisPartyHandle 为 NULL，则为 NULL。对于多点 VC，NDIS 会将此 CM 提供的 CallManagerPartyContext 句柄传递到与该方相关的 ProtocolCmXxx 函数的所有后续调用中。否则，NDIS 将忽略此参数。

[in] CallParameters

指向 CO_CALL_PARAMETERS 类型的结构的指针，该结构指定在状态为NDIS_STATUS_SUCCESS时为此连接设置的调用参数。

返回值

无

备注

仅当基础微型端口驱动程序准备好在 VC 上进行数据传输时，独立调用管理器才应使用 NDIS_STATUS_SUCCESS 调用 NdisMCmMMakeCallComplete 。也就是说，调用管理器已与网络协商以建立 VC 的调用参数，并成功调用了 NdisCmActivateVc 。

如果独立调用管理器的 ProtocolCmMakeCall 函数以前为给定的 NdisVcHandle 返回NDIS_STATUS_PENDING，则其 ProtocolCmMakeCallComplete 必须调用 NdisCmMakeCallComplete。在 CM 使用 NDIS_STATUS_SUCCESS 调用 NdisCmMakeCallComplete 之前，发起挂起的传出调用的客户端无法使用 VC 进行传输。

即使尝试的连接失败，在 CM 对 NdisCmMakeCallComplete 的调用导致调用该客户端之前，NDIS 和客户端都无法释放分配的资源以保持状态 ProtocolClMakeCallComplete 函数。事实上，如果因尝试设置此类连接失败而忽略调用 NdisCmMakeCallComplete ，也会导致调用管理器中的内存泄漏;它可防止客户端拆解为其失败的传出调用而创建的 VC，因此不会调用 CM 来释放它为该 VC 分配的资源。

如果 CM 通过错误（如 NDIS_STATUS_FAILURE），则 对于状态，它应该认为 NdisPartyHandle（如果有）在调用 NdisCmMakeCallComplete 后立即无效。当 NdisCmMakeCallComplete 返回控制权时，CM 可以释放 (或重新初始化以供重用) 它分配的任何资源来维护给定参与方的状态。随后将调用 CM 的 ProtocolCoDeleteVc 函数，以便在 CM 将错误状态传递给 NdisCmMakeCallComplete 时释放 CM 分配的任何资源，以便跟踪客户端创建的 VC 的状态。

在设置客户端发起的传出调用的过程中，CM 可以修改最初传入其 ProtocolCmMakeCall 函数的客户端提供的调用参数。如果这样做，则 CM 必须在调用 NdisCmMakeCallComplete 时在 CallParameters 的缓冲区中传递其修改。如果客户端发现这些修改后的调用参数不可接受，则会断开调用，这也会导致调用 CM 的 ProtocolCoDeleteVc 函数。

只有向 NDIS 注册为协议驱动程序的独立调用管理器才能调用 NdisCmMakeCallComplete。提供集成呼叫管理支持呼叫的微型端口驱动程序改为 NdisMCmMakeCallComplete 。

要求

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