NdisMCmDeleteVc 函数 (ndis.h)

NdisMCmDeleteVc 销毁调用方创建的 VC。

语法

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

参数

[in] NdisVcHandle

指定要删除的 VC 的句柄。 调用方最初从 NdisMCmCreateVc获取此句柄。

返回值

NdisMCmDeleteVc 可以返回以下项之一:

返回代码 描述
NDIS_STATUS_SUCCESS
NDIS 删除了 VC。
NDIS_STATUS_NOT_ACCEPTED
VC 仍然处于活动状态,因此无法删除它。

言论

当 MCM 驱动程序调用 NdisMCmDeleteVc时,必须对给定的 VC 没有未完成的调用,并且该 VC 必须已停用。 若要满足这些要求,MCM 驱动程序已成功调用 NdisMCmDeactivateVc 给定的 NdisVcHandle

只有创建特定 VC 的驱动程序才能删除该 VC。 调用 NdisMCmDeleteVc 会导致 NDIS 调用客户端的 ProtocolCoDeleteVc 函数,调用方与之共享 NdisVcHandle

NdisMCmDeleteVc 返回控件时,NdisVcHandle 不再有效。 MCM 驱动程序可以释放其分配的资源,以维护有关已删除的 VC 的状态,或者在调用 NdisMCmCreateVc后准备在后续传入通知中重复使用的资源。

驱动程序编写器确定 MCM 驱动程序是否具有一个(内部)MiniportCoDeleteVc 函数,驱动程序在拆毁传出和传入调用的连接上下文中调用。

只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才能调用 NdisMCmDeleteVc。 独立调用管理器和客户端,将其注册为协议驱动程序的 NDIS,请改为调用 NdisCoDeleteVc

要求

要求 价值
最低支持的客户端 Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序(请参阅 NdisMCmDeleteVc(NDIS 5.1)。 Windows XP 中支持 NDIS 5.1 驱动程序(请参阅 NdisMCmDeleteVc (NDIS 5.1)。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_MCM_Function(ndis)

另请参阅

MiniportCoDeleteVc

NdisCloseCall

NdisCoDeleteVc

NdisMCmCreateVc

NdisMCmDeactivateVc

ProtocolCoDeleteVc