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 给定的 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) |