NdisCoGetTapiCallId 函数 (ndis.h)

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

语法

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

参数

[in] NdisVcHandle

指定 VC 的 NDIS 句柄。 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) ) 。
目标平台 桌面
Header ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL DISPATCH_LEVEL
DDI 符合性规则 Irql_Connection_Function (ndis)

另请参阅

NdisClGetProtocolVcContextFromTapiCallId

NdisCoCreateVc