NdisMCoActivateVcComplete 函数 (ndis.h)

NdisMCoActivateVcComplete 通知 NDIS 和调用管理器,微型端口驱动程序已完成处理 CM 发起的 activate-VC 请求,微型端口驱动程序之前已返回该请求NDIS_STATUS_PENDING。

语法

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

参数

[in] Status

指定 activate-VC 操作的最终状态,该操作可以是NDIS_STATUS_SUCCESS或除NDIS_STATUS_PENDING以外的任何NDIS_STATUS_ XXX

[in] NdisVcHandle

指定标识 VC 的句柄。 调用方从其每个 VC 状态获取此句柄,该句柄由作为输入参数传递给其 的 MiniportVcContext 指定 MiniportCoActivateVc 函数。

[in] CallParameters

指向 CO_CALL_PARAMETERS 类型的结构的指针,由调用管理器提供,指定 VC 激活的调用和媒体参数。

返回值

备注

面向连接的微型端口驱动程序必须调用 NdisMCoActivateVcComplete ,如果其 MiniportCoActivateVc 函数以前返回NDIS_STATUS_PENDING,以响应激活或重新激活给定 NdisVcHandle 标识的 VC 的请求。 调用管理器通过调用 NdisCmActivateVc 发起 VC 激活,在微型端口驱动程序调用 NdisMCoActivateVcComplete 之前,无法通知 NDIS 或其客户端是否可以使用提供的调用参数对 VC 进行转移。

如果微型端口驱动程序发现 CM 提供的调用参数不可接受,则在调用 NdisMCoActivateVcComplete 时,VC 激活失败。 VC 的初始激活失败可能会导致创建 VC 的协议将其拆毁。 如果微型端口驱动程序未能请求使用新调用参数重新激活已建立的 VC,则必须还原为该 VC 建立的原始调用参数。 根据网络媒体的性质,如果在调用 NdisMCoActivateVcComplete 之前设置了 () 的舍入和/或舍入标志,微型端口驱动程序可以修改媒体参数。

调用 NdisMCoActivateVcComplete 会导致 NDIS 调用最初请求 VC 激活的调用管理器的 ProtocolCmActivateVcComplete 函数。

要求

要求
最低受支持的客户端 NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisMCoActivateVcComplete (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisMCoActivateVcComplete (NDIS 5.1) ) 。
目标平台 桌面
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 符合性规则 Irql_MCO_Function (ndis)

另请参阅

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisCmActivateVc

NdisCmDeactivateVc

ProtocolCmActivateVcComplete