NdisMCmDeleteVc 函数 (ndis.h)
NdisMCmDeleteVc 销毁调用方创建的 VC。
语法
NDIS_STATUS NdisMCmDeleteVc(
[in] NDIS_HANDLE NdisVcHandle
);
参数
[in] NdisVcHandle
指定要删除的 VC 的句柄。 调用方最初从 NdisMCmCreateVc 获取此句柄。
返回值
NdisMCmDeleteVc 可以返回下列值之一：
| 返回代码 | 说明 |
|---|---|
|
NDIS 删除了 VC。 |
|
VC 仍然处于活动状态，因此无法将其删除。 |
注解
当 MCM 驱动程序调用 NdisMCmDeleteVc 时，给定的 VC 上不得有未完成的调用，并且该 VC 必须已停用。 为了满足这些要求，意味着 MCM 驱动程序已成功使用给定 的 NdisMCmDeactivateVc调用了 NdisMCmDeactivateVc 。
只有创建了特定 VC 的驱动程序才能删除该 VC。 调用 NdisMCmDeleteVc 会导致 NDIS 调用调用方与之共享 NdisVcHandle 的客户端的 ProtocolCoDeleteVc 函数。
当 NdisMCmDeleteVc 返回控件时， NdisVcHandle 不再有效。 MCM 驱动程序可以释放其分配的资源，以维护已删除的 VC 的状态，或准备在调用 NdisMCmCreateVc 后在后续传入呼叫通知中重复使用这些资源。
驱动程序编写器确定 MCM 驱动程序是否具有 (内部) MiniportCoDeleteVc 函数，驱动程序在断开传出和传入呼叫的连接上下文中调用该函数。
只有提供集成呼叫管理支持的面向连接的微型端口驱动程序才能调用 NdisMCmDeleteVc。 将自己注册为协议驱动程序的 NDIS 的独立调用管理器和客户端改为调用 NdisCoDeleteVc 。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisMCmDeleteVc (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisMCmDeleteVc (NDIS 5.1) ) 。 |
| 目标平台 | 桌面 |
| 标头 | ndis.h (包括 Ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI 符合性规则 | Irql_MCM_Function (ndis) |