NdisMCmCloseCallComplete 宏 (ndis.h)

项目
08/07/2023

NdisMCmCloseCallComplete 返回客户端请求的最终状态（MCM 驱动程序之前已返回该请求NDIS_STATUS_PENDING），以删除调用。

语法

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

参数

_S_

指定 MCM 驱动程序关闭连接的客户端请求的最终状态，NDIS_STATUS_SUCCESS或任何调用方确定NDIS_STATUS_XXX （NDIS_STATUS_PENDING除外）。

_VH_

指定调用的 VC 的句柄。此句柄在最初创建 VC 时由 NDIS 提供，无论是由具有 NdisMCmCreateVc 的 MCM 驱动程序还是作为其 ProtocolCoCreateVc 函数的输入参数。

_PH_

如果 NdisVcHandle 表示点到点 VC，则指定 NULL，或者指定多点连接上最后一个剩余参与方的句柄，MCM 驱动程序从由 CallMgrPartyContext 指定的每方状态获取该句柄作为输入参数传递给其 ProtocolCmCloseCall 函数。

返回值

无

备注

如果 MCM 驱动程序的 ProtocolCmCloseCall 函数返回NDIS_STATUS_PENDING，则它必须随后调用 NdisMCmCloseCallComplete ，以通知客户端和 NDIS 中断连接的尝试已完成（无论成功还是出现错误）。调用 NdisMCmCloseCallComplete 会导致 NDIS 调用客户端的 ProtocolClCloseCallComplete 函数。

如果将NDIS_STATUS_SUCCESS作为 “状态”传递，MCM 驱动程序应考虑 NdisVcHandle (和 NdisPartyHandle（如果任何) 在调用 NdisMCmCloseCallComplete 后无法通过网络进行传输）。如果 MCM 驱动程序最初创建了 VC，它应使用刚传递给 NdisMCmCloseCallComplete 的同一 NdisMCmDeleteVc 调用 NdisMCmDeleteVc。如果客户端创建了此 VC，则 MCM 驱动程序可以期望使用调用其 ProtocolCoDeleteVc 函数
ProtocolVcContext，指定其存储同一 NdisVcHandle 作为输入参数的每个 VC 状态。

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

要求

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