NdisMCmDeleteVc 函式 (ndis.h)
NdisMCmDeleteVc 會終結呼叫端建立的 VC。
語法
NDIS_STATUS NdisMCmDeleteVc(
[in] NDIS_HANDLE NdisVcHandle
);
參數
[in] NdisVcHandle
指定要刪除之 VC 的句柄。 呼叫端原本從 NdisMCmCreateVc 取得此句柄。
傳回值
NdisMCmDeleteVc 可以傳回下列其中一項:
傳回碼 | Description |
---|---|
|
NDIS 已刪除 VC。 |
|
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) |