共用方式為


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

指定緩衝區的位元組大小,如果 BufferNULL,則為零。

傳回值

備註

在一般網路作業過程中,獨立通話管理員 ProtocolCoReceiveNetBufferLists 函式會呼叫 NdisCmDispatchIncomingDropParty ,並將 CloseStatus 設定為 NDIS_STATUS_SUCCESS,因為多點連線上的遠端用戶端已呼叫 NdisCloseCall

不過,如果發生異常網路狀況,呼叫管理員也可以呼叫 NdisCmDispatchIncomingDropParty 與 CM 決定的 CloseStatus ,如果發生異常網路狀況,例如本機用戶端與一或多個客戶端之間的交換器失敗, (在已建立的多點連線上) 。

呼叫 NdisCmDispatchIncomingDropParty 會導致 NDIS 呼叫用戶端的 ProtocolClIncomingDropParty 函 式。

如果 NdisPartyHandle 識別指定 VC 上的最後一個剩餘合作物件,CM 會呼叫 NdisCmDispatchIncomingCloseCall,而不是 NdisCmDispatchIncomingDropParty

只有向 NDIS 註冊為通訊協定驅動程式的獨立呼叫管理員,才能呼叫 NdisCmDispatchIncomingDropParty。 提供整合式呼叫管理支持的連線導向迷你埠驅動程式會改為呼叫 NdisMCmDispatchIncomingDropParty

規格需求

需求
最低支援的用戶端 (支援 NDIS 6.0 和 NDIS 5.1 驅動程式,請參閱 Windows Vista 中的 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 ()

另請參閱

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists