PROTOCOL_CM_DEACTIVATE_VC_COMPLETE回调函数 (ndis.h)

  • 项目

ProtocolCmDeactivateVcComplete 函数是必需函数。 ProtocolCmDeactivateVcComplete 完成调用管理器发起的请求的处理，该请求的基础微型端口驱动程序 (和 NDIS) 停用 NdisCmDeactivateVc 之前返回NDIS_STATUS_PENDING的 VC。

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

语法

PROTOCOL_CM_DEACTIVATE_VC_COMPLETE ProtocolCmDeactivateVcComplete;

void ProtocolCmDeactivateVcComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE CallMgrVcContext
)
{...}

参数

[in] Status

指定停用的最终状态。

[in] CallMgrVcContext

指定调用管理器分配的上下文区域的句柄，调用管理器在其中维护其每 VC 状态。 调用管理器从其 ProtocolCoCreateVc 函数向 NDIS 提供了此句柄。

返回值

无

备注

NDIS 通常在调用管理器代表面向连接的客户端关闭调用的上下文中调用 ProtocolCmDeactivateVcComplete 。 调用管理器通常从其 ProtocolCmCloseCall 函数调用 NdisCmDeactivateVc。 每当 NdisCmDeactivateVc 返回NDIS_STATUS_PENDING时，NDIS 就会调用其 ProtocolCmDeactivateVcComplete 函数。

也就是说，当面向连接的底层微型端口驱动程序停用 VC 时，NDIS 将调用 ProtocolCmDeactivateVcComplete。 停用的最终状态位于 状态 中。 最终状态的可能值包括但不限于：

ProtocolCmDeactivateVcComplete 执行完成虚拟连接停用所需的任何后处理，例如在其状态区域中设置标志，以指示连接处于非活动状态，或在 VC 处于活动状态时释放动态分配的资源。

完成停用意味着激活时使用的 VC 的所有调用参数不再有效。 禁止进一步使用 VC，除非使用一组新的调用参数重新激活它。

调用经理应释放为 VC 激活分配的任何资源，并尽快返回控制权。 如果调用管理器以前从其 ProtocolCmCloseCall 函数返回NDIS_STATUS_PENDING，并且关闭调用的所有操作都已完成， 则 ProtocolCmDeactivateVcComplete 现在应调用 NdisCmCloseCallComplete。

示例

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

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

PROTOCOL_CM_DEACTIVATE_VC_COMPLETE MyCmDeactivateVcComplete;

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

_Use_decl_annotations_
VOID
 MyCmDeactivateVcComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  CallMgrVcContext
    )
  {...}

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

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

要求

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

另请参阅

MiniportCoDeactivateVc

NdisCmCloseCallComplete

NdisCmDeactivateVc

ProtocolCmCloseCall