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

指定缓冲区的大小(以字节为单位)。如果 缓冲区NULL,则为零。

返回值

备注

在正常网络操作过程中,独立呼叫经理 ProtocolCoReceiveNetBufferLists 函数调用 NdisCmDispatchIncomingDropParty并将 CloseStatus 设置为NDIS_STATUS_SUCCESS,因为多点连接上的远程客户端已调用 NdisCloseCall

但是,如果出现异常网络状况,调用管理器还可以使用 CM 确定的 CloseStatus 调用 NdisCmDispatchIncomingDropParty(如果出现异常网络条件),例如本地客户端与一个或多个客户端之间路径上的开关失败, (在建立的多点连接上) 。

调用 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) ) 。
目标平台 桌面
Header ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_CallManager_Function (ndis)

另请参阅

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists