NdisMCmDeleteVc 函式 (ndis.h)

NdisMCmDeleteVc 會終結呼叫端建立的 VC。

語法

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

參數

[in] NdisVcHandle

指定要刪除之 VC 的句柄。 呼叫端原本從 NdisMCmCreateVc 取得此句柄。

傳回值

NdisMCmDeleteVc 可以傳回下列其中一項:

傳回碼 Description
NDIS_STATUS_SUCCESS
NDIS 已刪除 VC。
NDIS_STATUS_NOT_ACCEPTED
VC 仍在使用中,因此無法刪除。

備註

當 MCM 驅動程式呼叫 NdisMCmDeleteVc 時,指定的 VC 上不得有任何未完成的呼叫,而且該 VC 必須已停用。 若要符合這些需求,表示 MCM 驅動程式已成功呼叫 NdisMCmDeactivateVc ,並成功指定 NdisVcHandle

只有建立特定 VC 的驅動程式可以刪除該 VC。 呼叫 NdisMCmDeleteVc 會導致 NDIS 呼叫用戶端的 ProtocolCoDeleteVc 函式,呼叫端共用 NdisVcHandle

當 NdisMCmDeleteVc 傳回控件時,NdisVcHandle 已不再有效。 MCM 驅動程式可以釋放其配置的資源,以維護已刪除 VC 的狀態,或在呼叫 NdisMCmCreateVc 之後,準備在後續的連入通知中重複使用。

驅動程式寫入器會判斷 MCM 驅動程式是否有 (內部) MiniportCoDeleteVc 函式,驅動程式在卸除連出和連入呼叫的連線內容中呼叫。

只有提供整合式呼叫管理支持的連線導向迷你埠驅動程式可以呼叫 NdisMCmDeleteVc。 獨立呼叫管理員和用戶端,其會向 NDIS 註冊為通訊協定驅動程式,改為呼叫 NdisCoDeleteVc

規格需求

需求
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisMCmDeleteVc (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisMCmDeleteVc (NDIS 5.1) ) 。
目標平台 桌面
標頭 ndis.h (包括 Ndis.h)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 Irql_MCM_Function (ndis)

另請參閱

MiniportCoDeleteVc

NdisCloseCall

NdisCoDeleteVc

NdisMCmCreateVc

NdisMCmDeactivateVc

ProtocolCoDeleteVc