NdisCoDeleteVc 函数 (ndis.h)

NdisCoDeleteVc 销毁调用方创建的 VC。

语法

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

参数

[in] NdisVcHandle

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

返回值

NdisCoDeleteVc 可以返回以下项之一:

返回代码 描述
NDIS_STATUS_SUCCESS
NDIS 删除了 VC。
NDIS_STATUS_NOT_ACCEPTED
VC 仍然处于活动状态,因此无法删除它。
NDIS_STATUS_CLOSING
此调用是冗余的,但给定 VC 上的停用仍挂起。

言论

当协议 NdisCoDeleteVc时,给定的 VC 上必须没有未完成的调用,并且 VC 已停用。 若要满足这些要求,需要满足以下条件:

  • 如果调用拆解是由本地客户端启动的,则该客户端已使用给定的 NdisVcHandle 调用 NdisCloseCall,并且其近距离调用请求已成功完成。
  • 如果调用拆解是由远程客户端启动的,则独立调用管理器已调用 NdisCmDeactivateVc,给定的 NdisVcHandle 并且其停用请求已成功完成。
只有创建特定 VC 的协议才能删除该 VC。 调用 NdisCoDeleteVc 会导致 NDIS 同时调用基础微型端口驱动程序的 MiniportCoDeleteVc 函数和客户端或调用管理器的 ProtocolCoDeleteVc 函数,调用方与之共享 NdisVcHandle

NdisCoDeleteVc 返回控件时,NdisVcHandle 不再有效。

独立呼叫管理器,将其注册为协议驱动程序的 NDIS,可以调用 NdisCoDeleteVc。 面向连接的微型端口驱动程序,这些驱动程序提供集成的呼叫管理支持呼叫 NdisMCmDeleteVc

要求

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

另请参阅

MiniportCoDeleteVc

NdisCloseCall

NdisCmDeactivateVc

NdisCoCreateVc

NdisMCmDeleteVc

ProtocolCloseCallComplete

ProtocolClIncomingCloseCall

ProtocolCmCloseCall

ProtocolCoDeleteVc