共用方式為


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 驅動程式將會維護合作物件特定的狀態資訊。 否則,如果 Status 不是NDIS_STATUS_SUCCESS,則此參數可以 NULL,因為 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 指定相同的流量參數。
如果 MCM 驅動程式將 Status 設定為 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