NdisClGetProtocolVcContextFromTapiCallId 函数 (ndis.h)

  • 项目

NdisClGetProtocolVcContextFromTapiCallId 检索虚拟连接的客户端上下文 (VC) 由 TAPI 呼叫 ID 字符串标识。

语法

NDIS_STATUS NdisClGetProtocolVcContextFromTapiCallId(
  [in]  UNICODE_STRING TapiCallId,
  [out] PNDIS_HANDLE   ProtocolVcContext
);

参数

[in] TapiCallId

标识特定 VC 的 Unicode 字符串。 此字符串是以前由 NdisCoGetTapiCallID 函数返回的字符串标识符的 Unicode 版本。

[out] ProtocolVcContext

指向调用方分配的NDIS_HANDLE的指针，该NDIS_HANDLE接收 VC 客户端上下文的句柄。 客户端在从 其 ProtocolCoCreateVc 处理程序返回时向 NDIS 提供了此上下文。

返回值

返回以下状态值之一：

返回代码 说明
NDIS_STATUS_SUCCESS
 NDIS 已成功检索 TAPI 呼叫 ID 字符串标识的 VC 的客户端 VC 上下文的句柄。
NDIS_STATUS_FAILURE
 尝试检索客户端 VC 上下文的句柄失败。

注解

假设呼叫管理器调用 NdisCoCreateVc 为 TAPI 呼叫创建 VC。 NDIS 反过来向客户端提供 VC 的句柄。 客户端在调用 NdisCoGetTapiCallId 函数时传递此 VC 句柄，以检索 VC 的字符串标识符。 然后，客户端可以将此标识符作为 Unicode 字符串呈现给 NdisClGetProtocolVcContextFromTapiCallId ，以获取 VC 的上下文。

客户端为其管理的每个 VC 创建上下文。 客户端使用 NdisCoGetTapiCallId 检索每个 VC 的字符串标识符。 客户端将每个字符串标识符传递给 TAPI 应用程序，以标识每个 VC。 稍后，如果 TAPI 应用程序在与 VC 相关的操作中将这些字符串标识符之一向下传递给客户端，则客户端必须在调用 NdisClGetProtocolVcContextFromTapiCallId 时将此字符串标识符作为 Unicode 字符串传递，以获取 VC 的正确上下文。

有关详细信息，请参阅 UNICODE_STRING 结构。

要求

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

另请参阅

NdisCoCreateVc

NdisCoGetTapiCallId

UNICODE_STRING