NdisCmDeactivateVc 函式 (ndis.h)

NdisCmDeactivateVc 會通知 NDIS 和基礎迷你埠驅動程式,在特定作用中 VC 上不會進一步傳輸。

語法

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

參數

[in] NdisVcHandle

指定識別 VC 的控制碼。 當 NDIS 針對撥入電話呼叫呼叫 NdisCoCreateVc 或其 ProtocolCoCreateVc 函式設定用戶端起始的撥出電話時,NDIS 會提供這個控制碼給呼叫管理員。

傳回值

NdisCmDeactivateVc 傳回NDIS_STATUS_PENDING以外的任何專案時,呼叫管理員應該對其進行內部呼叫 ProtocolCmDeactivateVcComplete 函式 。 否則,NDIS 會在完成此作業時呼叫 CM 的 ProtocolCmDeactivateVcComplete 函式。

備註

獨立呼叫管理員會呼叫 NdisCmDeactivateVc 作為關閉通話的必要步驟,通常是在封包交換與卸載呼叫的網路元件之後。

呼叫 NdisCmDeactivateVc 會導致 NDIS 呼叫基礎迷你埠驅動程式的 MiniportCoDeactivateVc 函式,這會捨棄 VC 上傳輸的目前呼叫參數,可能會將它們重新初始化為迷你埠驅動程式決定的預設值。 如果後續針對另一個呼叫重新啟用 VC,用戶端或呼叫管理員會將新的呼叫參數提供給迷你埠驅動程式。

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

  • 在 VC 停用和關閉呼叫之後,用戶端可以重複使用原本建立的 VC,以使用 NdisClMakeCall進行另一個呼叫。
  • 在 VC 停用和結束呼叫之後,CM 可以重複使用原本建立的 VC,以指出相同用戶端的另一個連入呼叫 NdisCmDispatchIncomingCall
不會重複使用之特定 VC 的建立者,會呼叫 NdisCoDeleteVc 來終結該 VC。

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

規格需求

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

另請參閱

MiniportCoDeactivateVc

NdisCloseCall

NdisClMakeCall

NdisCmActivateVc

NdisCmDispatchIncomingCall

NdisMCmDeactivateVc

ProtocolCmCloseCall

ProtocolCmDeactivateVcComplete