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_ XXX,但 NDIS_STATUS_PENDING 除外。

[in] NdisVcHandle

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

[in] CallParameters

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

返回值

没有

言论

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

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

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

要求

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

另请参阅

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisCmActivateVc

NdisCmDeactivateVc

ProtocolCmActivateVcComplete