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 會導致 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) |