共用方式為


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 做為 Status
  • 在 CM 呼叫 NdisCmAddPartyComplete ,並將目前連線的每個合作物件變更為用戶端提供的值,並將 NDIS_STATUS_SUCCESS 做為 Status
  • 無法讓客戶端嘗試新增合作物件。 (這個替代方式會隱含地強制客戶端針對具有 NdisClMakeCall 的多點 VC 設定其流量參數,並在每個後續呼叫 NdisClAddParty 時針對指定的多點 VC.) 指定相同的流量參數
對於某些連線導向媒體而言,流量參數本質上是每一 VC,因此,對於多點 VC 上的所有合作物件而言相同。

如果 CM 將 Status 設定為 NDIS_STATUS_SUCCESS,它必須提供明確的句柄,這通常是 CM 配置之每一方狀態區域的指標,當呼叫 NdisCmAddPartyComplete 時,呼叫 CallMgrPartyContext

NdisCmAddPartyComplete 的呼叫會導致 NDIS 呼叫用戶端的 ProtocolClAddPartyComplete 函式

只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmAddPartyComplete。 提供整合式呼叫管理支援的連線導向迷你埠驅動程式會改為呼叫 NdisMCmAddPartyComplete

規格需求

需求
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisCmAddPartyComplete (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisCmAddPartyComplete (NDIS 5.1) ) 。
目標平台 桌面
標頭 ndis.h (包括 Ndis.h)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 Irql_CallManager_Function (ndis)

另請參閱

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLo一sideList

NdisClAddParty

NdisMCmAddPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty