NdisCmCloseCallComplete 函式 (ndis.h)
NdisCmCloseCallComplete 會傳回用戶端要求的最終狀態,而呼叫管理員先前傳回NDIS_STATUS_PENDING,以終止呼叫。
語法
void NdisCmCloseCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in, optional] NDIS_HANDLE NdisPartyHandle
);
參數
[in] Status
指定用戶端要求關閉連線的最終狀態,NDIS_STATUS_SUCCESS或任何 CM 決定的 NDIS_STATUS_XXX,但 NDIS_STATUS_PENDING 除外。
[in] NdisVcHandle
指定呼叫之 VC 的句柄。 當 VC 最初由呼叫管理員或用戶端建立時,NDIS 會提供此句柄,NdisCoCreateVc。 最近,呼叫管理員會從 CallMgrVcContext 所指定的每個 VC 狀態取得此句柄, 做為輸入參數傳遞給它的 ProtocolCmCloseCall 函式。
[in, optional] NdisPartyHandle
如果 NdisVcHandle 代表點對點 VC 或多點聯機上最後一個剩餘方的句柄,則指定 NULL ,這是從 CallMgrPartyContext 所指定之每一方狀態取得的 CM, 當做輸入參數傳遞至其 ProtocolCmCloseCall 函式。
傳回值
沒有
言論
如果獨立呼叫管理員的 ProtocolCmCloseCall 函式傳回NDIS_STATUS_PENDING,則 CM 必須呼叫 NdisCmCloseCallComplete,以通知用戶端和 NDIS 嘗試中斷連線已完成,無論成功還是發生錯誤。 呼叫 NdisCmCloseCallComplete 會導致 NDIS 呼叫用戶端的 ProtocolCloseCallComplete 函式。
如果它傳遞NDIS_STATUS_SUCCESS作為 狀態,呼叫管理員應該考慮 NdisVcHandle (且 NdisPartyHandle,如果有任何的話)無法透過網路傳輸,只要呼叫 NdisCmCloseCallComplete。 如果呼叫管理員最初建立 VC,它應該呼叫 NdisCoDeleteVc,NdisVcHandle 它剛傳遞給 NdisCmCloseCallComplete。 如果用戶端已建立此 VC,呼叫管理員可以使用 來預期呼叫其 ProtocolCoDeleteVc 函式
ProtocolVcContext,其中具有與輸入參數相同的 NdisVcHandle。
只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmCloseCallComplete。 提供整合式通話管理支援呼叫的連線導向迷你埠驅動程式,NdisMCmCloseCallComplete。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista 中支援 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 NdisCmCloseCallComplete (NDIS 5.1)。 支援 NDIS 5.1 驅動程式(請參閱 Windows XP 中的 NdisCmCloseCallComplete (NDIS 5.1)。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function(ndis) |