通过

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 对象。

要求

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

另请参阅

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc