NdisCmAddPartyComplete 函数 (ndis.h)

NdisCmAddPartyComplete 返回客户端请求的最终状态(调用管理器以前返回NDIS_STATUS_PENDING),以在已建立的多点 VC 上添加一个参与方。

语法

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

参数

[in] Status

指定调用管理器的加载项作的最终状态,NDIS_STATUS_SUCCESS或任何 NDIS_STATUS_XXX(NDIS_STATUS_PENDING除外)。

[in] NdisPartyHandle

指定标识参与方的句柄。 此句柄是调用管理器的 ProtocolCmAddParty 函数的输入。

[in, optional] CallMgrPartyContext

指定调用方分配的驻地上下文区域的句柄,如果添加方作成功,调用管理器将维护特定于参与方的状态信息。 否则,此参数可以 NULL,因为它将被忽略。

[in] CallParameters

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

返回值

没有

言论

如果独立调用管理器的 ProtocolCmAddParty 函数返回NDIS_STATUS_PENDING,则 CM 随后必须调用 NdisCmAddPartyComplete,以通知客户端和 NDIS 其尝试在多点 VC 上添加参与方已完成(无论成功还是出错)。

如果客户端在 CallParameters 传入的流量参数与为多点 VC 建立的流量参数不匹配,则调用管理器的设计器必须确定如何处理这种情况,但受网络媒体施加的任何约束。 可能性包括:

  • 如果基础网络媒体在多点 VM 上支持此功能,请设置每方流量参数。
  • 在 CM 调用 NdisCmAddPartyComplete 时,将客户端提供的流量参数重置为为 VC 建立的流量参数,NDIS_STATUS_SUCCESS作为 状态
  • 在 CM 调用 NdisCmAddPartyComplet e 之前,将 VC 的流量参数更改为客户端提供的值,NDIS_STATUS_SUCCESS作为 状态
  • 客户端尝试添加参与方失败。 (此替代方法隐式强制客户端为具有 NdisClMakeCall 的多点 VC 设置其流量参数,并在每次后续调用 NdisClAddParty 为给定的多点 VC 指定相同的流量参数。
对于一些面向连接的媒体,流量参数本质上是每 VC 的,因此,对于多点 VC 上的各方来说都是相同的。

如果 CM 状态 设置为NDIS_STATUS_SUCCESS,则它必须提供显式句柄,该句柄通常是指向 CM 分配的按方状态区域的指针,因为调用 NdisCmAddPartyComplete时,CallMgrPartyContext

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

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

要求

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

另请参阅

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisMCmAddPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty