NdisMCmDeactivateVc 通知 NDIS 特定作用中 VC 上不會再進行任何傳輸。
語法
NDIS_STATUS NdisMCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
參數
[in] NdisVcHandle
指定識別 VC 的句柄。 當 NDIS 呼叫 NdisMCmCreateVc 來電或其 ProtocolCoCreateVc 函式為用戶端起始的傳出呼叫設定 VC 時,NDIS 會提供此句柄給 MCM 驅動程式。
傳回值
NdisMCmDeactivateVc 可以傳回下列其中一項:
傳回碼 | 描述 |
---|---|
|
NDIS 會將 VC 標示為非使用中。 |
|
VC 已經停用,因此此呼叫是多餘的。 |
言論
MCM 驅動程式會呼叫 NdisMCmDeactivateVc 作為關閉呼叫的必要步驟,通常是在封包交換與中斷連線的網路元件之後。
成功呼叫 NdisMCmDeactivateVc 可讓 MCM 驅動程式捨棄目前在 VC 上進行傳輸的呼叫參數,可能將其重新初始化為迷你埠驅動程式決定的預設值。 不過,如果後續針對另一個呼叫重新啟用 VC,用戶端會提供新的呼叫參數給迷你埠驅動程式。
NdisVcHandle 傳遞至 NdisMCmDeactivateVc 完成 VC 停用後仍有效。 停用任何 VC 可讓其建立者重新初始化 VC 以重複使用或終結它:
- 在 VC 停用和結束呼叫之後,用戶端可以重複使用它最初建立的 VC,以使用 NdisClMakeCall進行另一個呼叫,或者它可以呼叫 NdisCoDeleteVc,因而導致呼叫 MCM 驅動程式的 ProtocolCoDeleteVc 函式。
- 在 VC 停用和結束呼叫之後,MCM 驅動程式可以重複使用它最初建立的 VC,以指出與相同用戶端的另一個連入呼叫 NdisMCmDispatchIncomingCall,或呼叫 NdisMCmDeleteVc。
只有提供整合式呼叫管理支援的連線導向迷你連接埠驅動程式可以呼叫 NdisMCmDeactivateVc。 以 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,請改為呼叫 NdisCmDeactivateVc。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 NdisMCmDeactivateVc (NDIS 5.1)。 支援 Windows XP 中的 NDIS 5.1 驅動程式(請參閱 NdisMCmDeactivateVc (NDIS 5.1)。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_MCM_Function(ndis) |