NdisMCmDispatchIncomingCloseCall 巨集（ndis.h）

發行項
02/07/2025

NdisMCmDispatchIncomingCloseCall 會告訴用戶端卸載作用中或提供的呼叫，通常是因為 MCM 驅動程式已收到來自網路以關閉連線的要求。

語法

void NdisMCmDispatchIncomingCloseCall(
   _S_,
   _H_,
   _B_,
   _Z_
);

參數

_S_

指定呼叫端決定NDIS_STATUS_XXX，指出中斷連線要求的原因。在一般網路作業期間，MCM 驅動程式會傳遞NDIS_STATUS_SUCCESS，表示它已收到遠端合作物件起始的要求，以關閉作用中的呼叫。

_H_

指定要中斷連線之呼叫之 VC 的句柄。當 VC 最初建立時，NDIS 會提供此句柄，無論是由 MCM 驅動程式搭配 NdisMCmCreateVc，還是做為其 ProtocolCoCreateVc 函式的輸入參數。

_B_

呼叫端配置的駐地緩衝區指標，其中包含其他通訊協定特定的中斷連線數據，如果有的話。視基礎媒體而定，此指標可以 NULL。

_Z_

指定緩衝區的位元組大小，如果 Buffer為 NULL，則為零。

傳回值

沒有

言論

在一般網路作業過程中，MCM 驅動程式會呼叫 NdisMCmDispatchIncomingCloseCall，並將 CloseStatus 設為 NDIS_STATUS_SUCCESS，因為遠端節點上的對應用戶端已呼叫 NdisCloseCall。

不過，如果發生下列其中一項，MCM 驅動程式也可以呼叫 NdisMCmDispatchIncomingCloseCall：

MCM 驅動程式已通知用戶端傳入通話供應專案。迷你埠驅動程序的時機 ProtocolCmIncomingCallComplete 函式是以用戶端接受來呼叫，它會驗證用戶端已修改的輸入呼叫參數。 ProtocolCmIncomingCallComplete 會決定用戶端提議連線不支援的呼叫參數，因此它會呼叫 NdisMCmDispatchIncomingCloseCall。
異常的網路狀況會強制 MCM 驅動程序終止作用中的呼叫。例如，如果當此用戶端與連線遠端方之間的任何連結中斷時，MCM 驅動程式會收到通知，迷你埠驅動程式會呼叫 NdisCmDispatchIncomingCloseCall，以防止客戶端嘗試或預期這類中斷連線上的進一步數據傳輸。

用戶端呼叫 NdisCloseCall 因而導致 VC 停用之後，VC 的原始建立者會負責終結 VC。用戶端會呼叫 NdisCoDeleteVc，這會導致 NDIS 呼叫 MCM 驅動程式的 ProtocolCoDeleteVc 函式，或 MCM 驅動程式在呼叫 NdisMCmDeactivateVc 後呼叫 NdisMCmDeleteVc，並釋放它與其建立之 VC 相關聯的任何其他資源。

呼叫 NdisMCmDispatchIncomingCloseCall 會導致 NDIS 呼叫用戶端的 ProtocolClIncomingCloseCall 函式。

只有提供通話管理支援的連線導向迷你埠驅動程式可以呼叫 NdisMCmDispatchIncomingCall。以 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員，請改為呼叫 NdisCmDispatchIncomingCloseCall。

要求

要求	價值
最低支援的用戶端	支援 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 Windows Vista 中的 NdisMCmDispatchIncomingCloseCall （NDIS 5.1）。支援 NDIS 5.1 驅動程式（請參閱 Windows XP 中的 NdisMCmDispatchIncomingCloseCall （NDIS 5.1）。
目標平臺	桌面
標頭	ndis.h （包括 Ndis.h）
IRQL	<= DISPATCH_LEVEL
DDI 合規性規則	Irql_MCM_Function（ndis）