通过

MINIPORT_CO_ACTIVATE_VC回调函数 （ndis.h）

  • 项目

面向连接的微型端口需要 MiniportCoActivateVc 函数。 MiniportCoActivateVc 由 NDIS 调用，以向微型端口驱动程序指示正在激活虚拟连接。

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

语法

MINIPORT_CO_ACTIVATE_VC MiniportCoActivateVc;

NDIS_STATUS MiniportCoActivateVc(
  [in]      NDIS_HANDLE MiniportVcContext,
  [in, out] PCO_CALL_PARAMETERS CallParameters
)
{...}

参数

[in] MiniportVcContext

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

[in, out] CallParameters

指定要为此 VC 建立的调用管理器指定的调用参数。 输出时，如果 CO_CALL_PARAMETERS 结构中设置了某些标志，微型端口驱动程序将返回更改的调用参数。

返回值

返回代码 描述
NDIS_STATUS_SUCCESS
 指示已成功激活 VC。
NDIS_STATUS_PENDING
 指示微型端口驱动程序将完成异步激活 VC 的请求。 微型端口驱动程序完成其作后，必须调用 NdisMCoActivateVcComplete。
NDIS_STATUS_INVALID_DATA
 指示在 CallParameters 中指定的调用参数 对于此微型端口驱动程序支持的媒体类型无效或非法。
NDIS_STATUS_RESOURCES
 指示微型端口驱动程序无法激活 VC，因为它无法分配微型端口驱动程序需要维护有关活动 VC 的状态信息所需的所有资源。

言论

微型端口驱动程序必须验证此 VC 的调用参数，如 CallParameters中指定的，以验证适配器是否可以支持请求的调用。 如果无法满足请求的调用参数，微型端口驱动程序应失败并NDIS_STATUS_INVALID_DATA请求。

MiniportCoActivateVc 可以为单个 VC 多次调用，以便更改已处于活动状态的调用的调用参数。 每次调用时，微型端口驱动程序都应验证参数，并按照适配器的要求执行任何处理，以满足请求。 但是，如果它无法设置给定的调用参数，MiniportCoActivateVc 必须将 VC 保留为可用状态，因为面向连接的客户端或调用管理器可以使用较旧的调用参数继续发送或接收数据。

如果在调用参数结构中设置了ROUND_UP_FLOW或ROUND_DOWN_FLOW标志，CallParameters->MediaParameters->标志，则要求微型端口驱动程序根据设置的相应标志舍入流速率后返回 VC 的实际流速率。 如果微型端口驱动程序确实更改了任何调用参数，因为这些标志已设置，则必须返回在 CallParameters处用于 VC 的实际调用参数。

如果可接受调用参数，MiniportCoActivateVc 根据需要与其适配器通信，以准备适配器以跨虚拟连接接收或传输数据（换句话说，编程接收缓冲区）。

示例

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

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

MINIPORT_CO_ACTIVATE_VC MyCoActivateVc;

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

_Use_decl_annotations_
NDIS_STATUS
 MyCoActivateVc(
    NDIS_HANDLE  MiniportVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

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

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

要求

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

另请参阅

MiniportCoCreateVc

MiniportCoDeactivateVc

NdisMCoActivateVcComplete