共用方式為


NdisMCmDeactivateVc 函式 (ndis.h)

NdisMCmDeactivateVc 會通知 NDIS 特定作用中 VC 上不會進一步傳輸。

語法

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

參數

[in] NdisVcHandle

指定識別 VC 的句柄。 當 NDIS 針對傳入呼叫呼叫 NdisMCmCreateVc 或其 ProtocolCoCreateVc 函式設定用戶端起始的傳出呼叫時,此句柄是由 MCM 驅動程式提供。

傳回值

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

傳回碼 Description
NDIS_STATUS_SUCCESS
NDIS 會將 VC 標示為非使用中。
NDIS_STATUS_NOT_ACCEPTED
VC 已經停用,因此此呼叫是多餘的。

備註

MCM 驅動程式會呼叫 NdisMCmDeactivateVc 作為關閉呼叫的必要步驟,通常是在封包交換與中斷連線的網路元件之後。

成功呼叫 NdisMMCmDeactivateVc 可讓 MCM 驅動程式捨棄目前呼叫參數以在 VC 上進行傳輸,可能會將它們重新初始化為迷你埠驅動程式決定的預設值。 不過,如果後續針對另一個呼叫重新啟用 VC,用戶端會將新的呼叫參數提供給迷你埠驅動程式。

傳遞至 NdisMCmDeactivateVcNdisVcHandle 在 VC 停用完成後仍有效。 任何 VC 的停用可讓其建立者重新初始化 VC 以供重複使用或終結:

  • 在 VC 停用和關閉呼叫之後,用戶端可以重複使用原本建立的 VC,以使用 NdisClMakeCall 進行另一個呼叫,或者可以呼叫 NdisCoDeleteVc,因而導致呼叫 MCM 驅動程式的 ProtocolCoDeleteVc 函式。
  • 在 VC 停用和關閉呼叫之後,MCM 驅動程式可以重複使用原本建立的 VC,以指出相同用戶端的另一個連入呼叫 NdisMCmDispatchIncomingCall,也可以呼叫 NdisMCmDeleteVc
驅動程式寫入器會判斷 MCM 驅動程式是否有 (內部) MiniportCoDeactivateVc 函式,驅動程式在卸除連出和連入呼叫的連線內容中呼叫。

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

規格需求

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

另請參閱

MiniportCoDeactivateVc

NdisCloseCall

NdisClMakeCall

NdisCmDeactivateVc

NdisMCmActivateVc

NdisMCmDeleteVc

NdisMCmDispatchIncomingCall

ProtocolCmCloseCall

ProtocolCoDeleteVc