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 驅動程式將會維護合作物件特定狀態資訊。否則，如果 Status 不是NDIS_STATUS_SUCCESS，則此參數可以是 NULL，因為 NDIS 會忽略此參數。

_P_

型別CO_CALL_PARAMETERS 結構的指標，該結構包含最初由用戶端提供的呼叫參數，以便新增合作物件。

傳回值

無

備註

如果 MCM 驅動程式的 ProtocolCmAddParty 函式傳回NDIS_STATUS_PENDING，則驅動程式必須在後續呼叫 NdisMCmAddPartyComplete ，以通知用戶端和 NDIS 其嘗試在多點 VC 上新增合作物件已完成，無論是成功還是 MCM 驅動程式判斷的錯誤狀態。

基礎網路媒體會決定用戶端是否可以在多點 VC 上指定每一方流量參數。

如果基礎網路媒體不支援多點 VM 上的每一方流量參數，則每當客戶端嘗試在 CallParameters 新增具有規格且不符合該 VC 已建立流量參數的 CallParameters 時，MCM 驅動程式都可以執行下列其中一項動作：

成功在該 VC 上新增合作物件時，將流量參數重設為已為多點 VC 建立的流量參數。
成功新增新合作物件時，請變更已在 VC 上之每一方的流量參數。
拒絕新增合作物件的要求。 (這個替代方式會隱含地強制客戶端針對具有 NdisClMakeCall 的多點 VC 設定其流量參數，並在每次後續針對指定的多點 VC.) 呼叫 NdisClAddParty 時指定相同的流量參數

如果 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)