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 的状态信息所需的所有资源。

注解

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

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

如果在 CallParameters-MediaParameters-Flags>> 的调用参数结构中设置了ROUND_UP_FLOW或ROUND_DOWN_FLOW标志，则已请求微型端口驱动程序在流速根据已设置的相应标志舍入后返回 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的信息，请参阅 批注函数行为。

要求

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

另请参阅

MiniportCoCreateVc

MiniportCoDeactivateVc

NdisMCoActivateVcComplete