NdisCmDispatchIncomingDropParty 函式 (ndis.h)
NdisCmDispatchIncomingDropParty 通知用戶端應該移除多點 VC 上的特定合作物件,通常是因為呼叫管理員已透過網路收到要求來關閉作用中的多點連線。
語法
void NdisCmDispatchIncomingDropParty(
[in] NDIS_STATUS DropStatus,
[in] NDIS_HANDLE NdisPartyHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
參數
[in] DropStatus
指出卸除此合作物件的原因,通常NDIS_STATUS_SUCCESS遠端合作物件只是要求關閉其連線。
[in] NdisPartyHandle
指定要從多點 VC 卸除之合作物件的句柄,此句柄必須有其他仍在連接的合作物件。
[in, optional] Buffer
呼叫端配置的駐地緩衝區指標,其中包含從遠端合作物件接收的其他通訊協定特定數據,如果有的話。 視基礎媒體而定,此指標可以 NULL。
[in] Size
指定緩衝區的位元組大小,如果 Buffer為 NULL,則為零。
傳回值
沒有
言論
在正常網路作業過程中,獨立通話管理員的 ProtocolCoReceiveNetBufferLists 函式會呼叫 NdisCmDispatchIncomingDropParty,並將 CloseStatus 設為 NDIS_STATUS_SUCCESS,因為多點連線上的遠端用戶端已呼叫 NdisCloseCall。
不過,如果發生異常網路狀況,呼叫管理員也可以呼叫 NdisCmDispatchIncomingDropParty CM 決定的 CloseStatus 網路本身,例如本機用戶端與已建立多點連線上一或多個客戶端之間的交換器失敗。
呼叫 NdisCmDispatchIncomingDropParty 會導致 NDIS 呼叫用戶端的 ProtocolClIncomingDropParty 函式。
如果 NdisPartyHandle 識別指定 VC 上的最後一個剩餘合作物件,CM 會呼叫 NdisCmDispatchIncomingCloseCall,而不是 NdisCmDispatchIncomingDropParty。
只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmDispatchIncomingDropParty。 提供整合式通話管理支持的連線迷你埠驅動程式,NdisMCmDispatchIncomingDropParty。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式(請參閱 NdisCmDispatchIncomingDropParty (NDIS 5.1)。 支援 NDIS 5.1 驅動程式(請參閱 Windows XP 中的 NdisCmDispatchIncomingDropParty (NDIS 5.1) 。 |
目標平臺 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
連結庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_CallManager_Function(ndis) |