NdisCmDeactivateVc 函式 (ndis.h)
NdisCmDeactivateVc 通知 NDIS 和基礎迷你埠驅動程式,特定作用中 VC 上不會有進一步的傳輸。
語法
NDIS_STATUS NdisCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
參數
[in] NdisVcHandle
指定識別 VC 的句柄。 此句柄是由 NDIS 提供給呼叫管理員,其呼叫 NdisCoCreateVc 來電,或當其 ProtocolCoCreateVc 函式為用戶端起始的傳出呼叫設定 VC 時。
傳回值
NdisCmDeactivateVc 傳回NDIS_STATUS_PENDING以外的任何專案時,呼叫管理員應該對其進行內部呼叫 ProtocolCmDeactivateVcComplete 函式。 否則,當此作業完成時,NDIS 會呼叫 CM 的 ProtocolCmDeactivateVcComplete 函式。
言論
獨立呼叫管理員會呼叫 NdisCmDeactivateVc 做為關閉呼叫的必要步驟,通常是在封包交換與中斷呼叫的網路元件之後。
對 NdisCmDeactivateVc 的呼叫 會導致 NDIS 呼叫基礎迷你埠驅動程式的 MiniportCoDeactivateVc 函式,而函式可能會捨棄目前在 VC 上傳輸的呼叫參數,可能會將它們重新初始化為迷你埠驅動程式決定的預設值。 如果後續針對另一個呼叫重新啟用 VC,用戶端或呼叫管理員會將新的呼叫參數提供給迷你埠驅動程式。
NdisVcHandle 傳遞至 NdisCmDeactivateVc 完成 VC 停用之後仍有效。 停用任何 VC 可讓其建立者重新初始化 VC 以供重複使用:
- 在 VC 停用和結束呼叫之後,用戶端可以重複使用它最初建立的 VC,以使用 NdisClMakeCall 進行另一個呼叫,。
- 在 VC 停用和結束呼叫之後,CM 可以重複使用它最初建立的 VC,以指出與相同用戶端的另一個連入呼叫 NdisCmDispatchIncomingCall。
只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmDeactivateVc。 提供整合式通話管理支援呼叫的連線導向迷你埠驅動程式,NdisMCmDeactivateVc。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 NdisCmDeactivateVc (NDIS 5.1)。 支援 Windows XP 中的 NDIS 5.1 驅動程式(請參閱 NdisCmDeactivateVc (NDIS 5.1)。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function(ndis) |