PROTOCOL_CO_DELETE_VC回调函数 (ndis.h)

项目
02/29/2024

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 返回控件时，其 ProtocolCoCreateVc 函数存储在 ProtocolVcContext 区域中的 NdisVcHandle 将变为无效。

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的信息，请参阅批注函数行为。

要求

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