NdisMCmAddPartyComplete 宏 (ndis.h)

NdisMCmAddPartyComplete 返回客户端请求的最终状态,MCM 驱动程序以前返回NDIS_STATUS_PENDING,以在已建立的多点 VC 上添加一个参与方。

语法

void NdisMCmAddPartyComplete(
  _S_,
  _H_,
  _C_,
  _P_
);

参数

_S_

指定 MCM 驱动程序的加载项作的最终状态,NDIS_STATUS_SUCCESS或任何 NDIS_STATUS_XXX NDIS_STATUS_PENDING 除外。

_H_

指定标识参与方的句柄。 MCM 驱动程序获取此句柄作为其 ProtocolCmAddParty 函数的输入参数。

_C_

指定调用方分配的驻地上下文区域的句柄,如果添加方作成功,MCM 驱动程序将维护特定于方的状态信息。 否则,此参数可以 NULL,因为如果 状态 不是NDIS_STATUS_SUCCESS,则 NDIS 会忽略此参数。

_P_

指向 CO_CALL_PARAMETERS 类型的结构的指针,该结构包含最初由客户端提供的调用参数,以便添加参与方。

返回值

没有

言论

如果 MCM 驱动程序的 ProtocolCmAddParty 函数返回NDIS_STATUS_PENDING,驱动程序必须随后调用 NdisMCmAddPartyComplete,以通知客户端和 NDIS 其尝试在多点 VC 上添加参与方已完成(无论成功还是具有 MCM 驱动程序确定的错误状态)。

基础网络媒体确定客户端是否可以在多点 VC 上指定每方流量参数。

如果基础网络介质不支持多点 VM 上的每方流量参数,则每当客户端尝试在 CallParameters 添加具有规范的参与方时,MCM 驱动程序都可以执行以下作之一, 与该 VC 已建立的流量参数不匹配:

  • 成功在该 VC 上添加参与方时,将流量参数重置为已为多点 VC 建立的流量参数。
  • 成功添加新方时,更改已位于 VC 上的每个参与方的流量参数。
  • 拒绝添加新方的请求。 (此替代方法隐式强制客户端为具有 NdisClMakeCall 的多点 VC 设置其流量参数,并在每次后续调用 NdisClAddParty 为给定的多点 VC 指定相同的流量参数。
如果 MCM 驱动程序 状态 设置为NDIS_STATUS_SUCCESS,则它必须提供显式句柄,这通常是指向驱动程序分配的按方状态区域的指针,因为调用 NdisMCmAddPartyComplete时,CallMgrPartyContext

调用 NdisMCmAddPartyComplete 会导致 NDIS 调用客户端的 ProtocolClAddPartyComplete 函数。

只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才能调用 NdisMCmAddPartyComplete。 独立呼叫管理器,将其注册为协议驱动程序的 NDIS,请改为调用 NdisCmAddPartyComplete

要求

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

另请参阅

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisCmAddPartyComplete

NdisMCmDropPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty