NdisMCmDispatchIncomingDropParty 宏 (ndis.h)
NdisMCmDispatchIncomingDropParty 通知客户端它应删除多点 VC 上的特定参与方。
语法
void NdisMCmDispatchIncomingDropParty(
_S_,
_H_,
_B_,
_Z_
);
参数
_S_
指示删除此参与方的原因,如果远程方只是请求关闭其连接,通常NDIS_STATUS_SUCCESS。
_H_
指定句柄,该句柄标识要从多点 VC 中删除的参与方,该方必须具有仍在连接的其他参与方。 MCM 驱动程序最初获取此句柄作为其 ProtocolCmAddParty 函数的输入参数。
_B_
指向调用方分配的常驻缓冲区的指针,该缓冲区包含从远程方接收的其他特定于协议的数据(如果有)。 根据基础介质,此指针可以为 NULL。
_Z_
指定缓冲区的大小(以字节为单位),如果缓冲区为 NULL,则为零。
返回值
无
备注
在正常网络操作过程中,MCM 驱动程序调用 NdisMCmDispatchIncomingDropParty 并将 CloseStatus 设置为 NDIS_STATUS_SUCCESS,因为多点连接的远程客户端已调用 NdisClClCloseCall。
但是,如果发生异常网络情况,MCM 驱动程序还可以使用驱动程序确定的 CloseStatus 调用 NdisMCmDispatchIncomingDropParty,如果出现异常网络情况,例如本地客户端与一个或多个客户端 () 建立的多点连接之间的路径上的交换机发生故障。
调用 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) |