通过

NdisCoGetTapiCallId 函数 (ndis.h)

  • 项目

NdisCoGetTapiCallId 检索 TAPI 应用程序可用于标识特定 NDIS 虚拟连接 (VC) 的字符串。

语法

NDIS_STATUS NdisCoGetTapiCallId(
  [in]      NDIS_HANDLE NdisVcHandle,
  [in, out] PVAR_STRING TapiCallId
);

参数

[in] NdisVcHandle

指定 VC 的 NDIS 句柄。 此句柄在最初使用 NdisCoCreateVc 函数创建 VC 时由 NDIS 提供。

[in, out] TapiCallId

指向调用方分配的缓冲区的指针，该缓冲区接收VAR_STRING类型的数据结构。 成功返回后，此结构描述 TAPI 应用程序可用于标识 VC 的字符串。

返回值

返回以下状态值之一：

返回代码 说明
NDIS_STATUS_SUCCESS
 NDIS 已成功返回 VC 的字符串标识符。
NDIS_STATUS_BUFFER_TOO_SHORT
 VAR_STRING 结构的 ulTotalSize 成员指定缓冲区的大小不足以容纳标识 VC 的字符串。 NdisCoGetTapiCallId 将 VAR_STRING 结构的 ulNeededSize 成员设置为所需的大小（以字节为单位）。
NDIS_STATUS_INVALID_DATA
 NdisVcHandle 指定的 VC 句柄无效。

注解

假设呼叫管理器调用 NdisCoCreateVc 为 TAPI 呼叫创建 VC。 NDIS 反过来向客户端提供 VC 的句柄。 客户端在调用 NdisCoGetTapiCallId 函数时传递此 VC 句柄，以检索标识 VC 的字符串。 客户端可以将此字符串标识符传递给 TAPI 应用程序以标识 VC。

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

有关VAR_STRING结构的详细信息，请参阅 TAPI 对象。

要求

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

另请参阅

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc