共用方式為


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 呼叫 NdisCmAddPartyComplet e 之前,將 VC 的流量參數變更為用戶端提供的值,並將 NDIS_STATUS_SUCCESS NDIS_STATUS_SUCCESS 變更為 狀態
  • 用戶端嘗試新增合作對象失敗。 (這個替代方案會隱含地強制用戶端為具有 NdisClMakeCall 的多點 VC 設定其流量參數,並在後續每次呼叫 NdisClAddParty 指定相同的流量參數。
對於某些連線導向媒體,流量參數本質上是每個 VC,因此,對於多點 VC 上的各方而言,都是相同的。

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

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

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

要求

要求 價值
最低支援的用戶端 Windows Vista 中支援 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 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

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisMCmAddPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty