通过

MINIPORT_CO_DEACTIVATE_VC回调函数 （ndis.h）

  • 项目

面向连接的微型端口需要 MiniportCoDeactivateVc 函数。 MiniportCoDeactivateVc 由 NDIS 调用，以指示 VC 标记为不可用。

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

语法

MINIPORT_CO_DEACTIVATE_VC MiniportCoDeactivateVc;

NDIS_STATUS MiniportCoDeactivateVc(
  [in] NDIS_HANDLE MiniportVcContext
)
{...}

参数

[in] MiniportVcContext

指定微型端口驱动程序分配的上下文区域的句柄，微型端口驱动程序在其中维护每个 VC 的状态信息。 微型端口驱动程序从其 MiniportCoCreateVc 函数向 NDIS 提供此句柄。

返回值

返回代码 描述
NDIS_STATUS_SUCCESS
 指示微型端口驱动程序已成功停止跨 VC 的任何通信，并将其标记为不可用。
NDIS_STATUS_PENDING
 指示微型端口驱动程序将完成以异步方式停止 VC 的请求。 微型端口驱动程序完成停止 VC 后，必须调用 NdisMCoDeactivateVcComplete，以向 NDIS 发出该作已完成的信号。

言论

MiniportCoDeactivateVc 与其网络适配器通信，以终止此 VC 的所有通信（换句话说，取消编程适配器上的接收或发送缓冲区）。 微型端口驱动程序还应将 VC（其上下文区域）标记为处于非活动状态，以防止在 VC 之间进一步通信。

调用 miniportCoActivateVc 和 MiniportCoDeactivateVc之间不存在一对一关系。 虽然 NDIS 可以在单个 VC 上多次调用 MiniportCoActivateVc，但仅对 MiniportCoDeactivateVc 进行一次调用来关闭虚拟连接。 例如，可以对不同的调用重复使用 VC，这可能会导致多个调用 MiniportCoActivateVc。

示例

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

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

MINIPORT_CO_DEACTIVATE_VC MyCoDeactivateVc;

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

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeactivateVc(
    NDIS_HANDLE  MiniportVcContext
    )
  {...}

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

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

要求

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

另请参阅

MiniportCoActivateVc

NdisMCoDeactivateVcComplete