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 指定相同的流量參數。
如果 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) |