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。
但是,如果出现异常网络条件,则调用管理器还可以调用 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) |