NdisMCmDeleteVc 函式 (ndis.h)
NdisMCmDeleteVc 會終結呼叫端建立的 VC。
語法
NDIS_STATUS NdisMCmDeleteVc(
[in] NDIS_HANDLE NdisVcHandle
);
參數
[in] NdisVcHandle
指定要刪除之 VC 的句柄。 呼叫端原本從 NdisMCmCreateVc取得此句柄。
傳回值
NdisMCmDeleteVc 可以傳回下列其中一項:
傳回碼 | 描述 |
---|---|
|
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。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 NdisMCmDeleteVc (NDIS 5.1)。 支援 Windows XP 中的 NDIS 5.1 驅動程式(請參閱 NdisMCmDeleteVc (NDIS 5.1)。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_MCM_Function(ndis) |