NdisMCmDeactivateVc 函数 (ndis.h)
NdisMCmDeactivateVc 通知 NDIS 特定活动 VC 上不会进一步传输。
语法
NDIS_STATUS NdisMCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
参数
[in] NdisVcHandle
指定标识 VC 的句柄。 此句柄由 NDIS 提供给 MCM 驱动程序,无论是为传入调用调用调用 NdisMCmCreateVc,还是当其 ProtocolCoCreateVc 函数为客户端发起的传出调用设置 VC 时。
返回值
NdisMCmDeactivateVc 可以返回以下项之一:
返回代码 | 描述 |
---|---|
|
NDIS 将 VC 标记为非活动状态。 |
|
VC 已停用,因此此调用是冗余的。 |
言论
MCM 驱动程序调用 NdisMCmDeactivateVc 作为关闭调用的重要步骤,通常是在与断开连接的网络组件进行数据包交换之后。
成功调用 NdisMCmDeactivateVc 允许 MCM 驱动程序放弃当前调用参数,以便在 VC 上传输,可能将其重新初始化为微型端口驱动程序确定的默认值。 但是,如果随后为另一个调用重新激活 VC,客户端将向微型端口驱动程序提供新的调用参数。
传递给 NdisMCmDeactivateVc 的 NdisVcHandle 在完成 VC 停用后仍然有效。 任何 VC 的停用都允许其创建者重新初始化 VC 以重复使用或销毁它:
- 在 VC 停用和结束调用后,客户端可以重复使用最初创建的 VC,以使用 NdisClMakeCall进行另一次调用,或者它可以调用 NdisCoDeleteVc,从而导致调用 MCM 驱动程序的 ProtocolCoDeleteVc 函数。
- 在 VC 停用和结束调用后,MCM 驱动程序可以重复使用最初创建的 VC,以指示对同一客户端的另一个传入调用 NdisMCmDispatchIncomingCall,也可以调用 NdisMCmDeleteVc。
只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才能调用 NdisMCmDeactivateVc。 独立呼叫管理器,将其注册为协议驱动程序的 NDIS,请改为调用 NdisCmDeactivateVc。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisMCmDeactivateVc(NDIS 5.1)。 在 Windows XP 中支持 NDIS 5.1 驱动程序(请参阅 NdisMCmDeactivateVc (NDIS 5.1)。 |
目标平台 | 桌面 |
标头 | ndis.h (包括 Ndis.h) |
库 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 符合性规则 | Irql_MCM_Function(ndis) |