NdisMCmDispatchIncomingDropParty 宏 (ndis.h)
NdisMCmDispatchIncomingDropParty 通知用戶端應該移除多點 VC 上的特定物件。
語法
void NdisMCmDispatchIncomingDropParty(
_S_,
_H_,
_B_,
_Z_
);
參數
_S_
指出此合作物件遭到卸除的原因,通常NDIS_STATUS_SUCCESS,如果遠端合作物件只要求關閉其連線。
_H_
指定要從多點 VC 卸除之合作物件的句柄,此句柄必須有其他仍然連接的合作物件。 MCM 驅動程式原本是以其 ProtocolCmAddParty 函式 的輸入參數的形式取得此句柄。
_B_
呼叫端配置的駐留緩衝區指標,其中包含從遠端合作物件接收的其他通訊協定特定數據。如果有的話。 視基礎媒體而定,此指標可以是 NULL。
_Z_
指定緩衝區的位元組大小,如果 Buffer 為 NULL,則為零。
傳回值
無
備註
在正常網路作業過程中,MCM 驅動程式會呼叫 NdisMCmDispatchIncomingDropParty ,並將 CloseStatus 設定為 NDIS_STATUS_SUCCESS,因為多點連線上的遠端用戶端稱為 NdisCloseCall。
不過,如果發生異常網路狀況,MCM 驅動程式也可以呼叫 NdisMCmDispatchIncomingDropParty ,並在網路本身的驅動程序判斷為 CloseStatus 的情況下呼叫 NdisMCmDispatchIncomingDropParty,例如本機用戶端與一或多個用戶端之間的交換器失敗, (在建立的多點連線上) 。
呼叫 NdisMCmDispatchIncomingDropParty 會導致 NDIS 呼叫用戶端的 ProtocolClIncomingDropParty 函式 。
如果 NdisPartyHandle 識別指定 VC 上的最後一個剩餘合作物件,MCM 驅動程式會呼叫 NdisMCmDispatchIncomingCloseCall,而不是 NdisMCmDispatchIncomingDropParty。
只有提供整合式呼叫管理支援的連線導向迷你埠驅動程式可以呼叫 NdisMCmDispatchIncomingDropParty。 獨立呼叫管理員,其向NDIS註冊為通訊協定驅動程式,改為呼叫 NdisCmDispatchIncomingDropParty 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 支援 NDIS 6.0 和 NDIS 5.1 驅動程式 (請參閱 Windows Vista 中的 NdisMCmDispatchIncomingDropParty (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisMCmDispatchIncomingDropParty (NDIS 5.1) ) 。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_MCM_Function (ndis) |