NdisMCmCloseCallComplete 宏 (ndis.h)
NdisMCmCloseCallComplete 會傳回用戶端要求的最終狀態,MCM 驅動程式先前傳回NDIS_STATUS_PENDING,以終止呼叫。
語法
void NdisMCmCloseCallComplete(
_S_,
_VH_,
_PH_
);
參數
_S_
指定用戶端要求的最終狀態,指出 MCM 驅動程式關閉連線,NDIS_STATUS_SUCCESS或任何呼叫端決定的NDIS_STATUS_XXX ,但NDIS_STATUS_PENDING除外。
_VH_
指定呼叫之 VC 的句柄。 當最初建立 VC 時,NDIS 會提供這個句柄,無論是由 MCM 驅動程式搭配 NdisMCmCreateVc ,還是作為其 ProtocolCoCreateVc 函式的輸入參數。
_PH_
如果 NdisVcHandle 代表點對點 VC 或多點連線上最後一個剩餘方的句柄,則指定 NULL,MCM 驅動程式會從呼叫MgrPartyContext 所指定的每一方狀態取得,而呼叫MgrPartyContext 傳遞為輸入參數給它的輸入參數 ProtocolCmCloseCall 函式 。
傳回值
無
備註
如果 MCM 驅動程式的 ProtocolCmCloseCall 函式傳回NDIS_STATUS_PENDING,則後續必須呼叫 NdisMCmCloseCallComplete ,通知用戶端和 NDIS 嘗試中斷連線已順利完成,無論是成功還是發生錯誤。 呼叫 NdisMCmCloseCallComplete 會導致 NDIS 呼叫用戶端的 ProtocolCloseCallComplete 函式 。
如果它傳遞NDIS_STATUS_SUCCESS為 Status,MCM 驅動程式應該考慮 NdisVcHandle (和 NdisPartyHandle,如果任何) 無法透過網路傳輸,只要呼叫 NdisMCmCloseCallComplete 即可。 如果 MCM 驅動程式最初建立了 VC,它應該呼叫 NdisMCmDeleteVc,其與剛傳遞至 NdisMCmCloseCallComplete 的 NdisVcHandle 相同。 如果用戶端已建立此 VC,MCM 驅動程式可能會預期使用 呼叫其 ProtocolCoDeleteVc 函式
ProtocolVcContext,指定其每個 VC 狀態,其儲存的 NdisVcHandle 與輸入參數相同。
只有提供整合式呼叫管理支援的連線導向迷你埠驅動程式可以呼叫 NdisMCmCloseCallComplete。 獨立呼叫管理員,其向NDIS註冊為通訊協定驅動程式,改為呼叫 NdisCmCloseCallComplete 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 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) |