PROTOCOL_CO_DELETE_VC回调函数（ndis.h）

项目
02/07/2025

需要 ProtocolCoDeleteVc 函数。此函数将断开客户端的状态或调用管理器的状态，该虚拟连接正由该 VC 的原始创建者关闭。

注意必须使用 PROTOCOL_CO_DELETE_VC 类型声明函数。有关详细信息，请参阅以下示例部分。

语法

PROTOCOL_CO_DELETE_VC ProtocolCoDeleteVc;

NDIS_STATUS ProtocolCoDeleteVc(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

参数

[in] ProtocolVcContext

指定客户端或调用管理器的每个 VC 上下文区域的句柄。协议最初从其 ProtocolCoCreateVc 函数中提供此句柄。

返回值

ProtocolCoDeleteVc 可以返回以下项之一：

返回代码	描述
NDIS_STATUS_SUCCESS	协议已释放或准备重复使用最初为 VC 分配的所有资源。
NDIS_STATUS_NOT_ACCEPTED	VC 仍然处于活动状态，协议在 VC 上挂起未完成的作，因此无法销毁它。
NDIS_STATUS_XXX	由于驱动程序确定的原因，协议未能删除 VC。

言论

ProtocolCoDeleteVc 是驱动程序的 ProtocolCoCreateVc 函数的相互函数。通常，它会释放调用管理器或客户端以前分配的任何动态资源和结构，以对活动 VC 执行作。

当 ProtocolCoDeleteVc 使用 NDIS_STATUS_SUCCESS 返回控制权时，NdisVcHandle 其存储在 ProtocolVcContext 区域中的 ProtocolCoCreateVc 函数无效。

ProtocolCoDeleteVc 可以返回任何驱动程序确定NDIS_STATUS_XXX 无法删除 VC，但它无法返回NDIS_STATUS_PENDING。对 ProtocolCoDeleteVc 的调用本质上是同步的。

示例

若要定义 ProtocolCoDeleteVc 函数，必须先提供一个函数声明来标识要定义的函数的类型。 Windows 为驱动程序提供了一组函数类型。使用函数类型声明函数有助于驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。

例如，若要定义名为“MyCoDeleteVc”的 ProtocolCoDeleteVc 函数，请使用 PROTOCOL_CO_DELETE_VC 类型，如以下代码示例所示：

PROTOCOL_CO_DELETE_VC MyCoDeleteVc;

然后，按如下所示实现函数：

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

PROTOCOL_CO_DELETE_VC 函数类型在 Ndis.h 头文件中定义。若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 PROTOCOL_CO_DELETE_VC 函数类型的批注。有关函数声明要求的详细信息，请参阅使用 NDIS 驱动程序的函数角色类型声明函数。

有关 Use_decl_annotations的信息，请参阅批注函数行为。

要求

要求	价值
最低支持的客户端	Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序（请参阅 ProtocolCoDeleteVc （NDIS 5.1）。 Windows XP 中支持 NDIS 5.1 驱动程序（请参阅 ProtocolCoDeleteVc （NDIS 5.1）。
目标平台	窗户
标头	ndis.h （包括 Ndis.h）
IRQL	<= DISPATCH_LEVEL