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) |