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 新增具有規格且不符合該 VC 已建立流量參數的 CallParameters 時,MCM 驅動程式都可以執行下列其中一項動作:
- 成功在該 VC 上新增合作物件時,將流量參數重設為已為多點 VC 建立的流量參數。
- 成功新增新合作物件時,請變更已在 VC 上之每一方的流量參數。
- 拒絕新增合作物件的要求。 (這個替代方式會隱含地強制客戶端針對具有 NdisClMakeCall 的多點 VC 設定其流量參數,並在每次後續針對指定的多點 VC.) 呼叫 NdisClAddParty 時指定相同的流量參數
呼叫 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) |