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