NdisMCmAddPartyComplete 宏 (ndis.h)

项目
02/26/2024

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 ，因为如果 Status 不是NDIS_STATUS_SUCCESS，则 NDIS 会忽略它。

_P_

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

返回值

无

备注

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

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

如果基础网络媒体不支持多点 VC 上的每方流量参数，则每当客户端尝试在 CallParameters 中添加规范与该 VC 已建立的流量参数不匹配的参与方时，MCM 驱动程序可以执行以下操作之一：

在多点 VC 上成功添加参与方后，将流量参数重置为已为多点 VC 建立的流量参数。
在成功添加新参与方后，更改 VC 上已有的每个参与方的流量参数。
拒绝添加新参与方的请求。 (此替代方法隐式强制客户端使用 NdisClMakeCall 为多点 VC 设置其流量参数，并在每次后续调用 NdisClAddParty 时为给定的多点 VC.)

如果 MCM 驱动程序将 Status 设置为 NDIS_STATUS_SUCCESS，则它必须提供显式句柄，该句柄通常是指向驱动程序分配的每方状态区域的指针，在调用 NdisMCmAddPartyComplete 时作为 CallMgrPartyContext。

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

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

要求

要求	值
最低受支持的客户端	支持 NDIS 6.0 和 NDIS 5.1 驱动程序 (请参阅 Windows Vista 中的 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)