NdisCmDeactivateVc 函式 (ndis.h)

發行項
03/05/2024

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

語法

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

參數

[in] NdisVcHandle

指定識別 VC 的句柄。當 NDIS 針對傳入呼叫呼叫 NdisCoCreateVc ，或是其 ProtocolCoCreateVc 函式為用戶端起始的傳出呼叫設定 VC 時，NDIS 會提供此句柄給呼叫管理員。

傳回值

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

備註

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

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

傳遞至 NdisCmDeactivateVc 的 NdisVcHandle 在 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 ()