通过

TSPI_phoneGetID 函数 (tspi.h)

  • 项目

TSPI_phoneGetID 函数返回与指定电话设备关联的给定设备类的设备标识符。

语法

LONG TSPIAPI TSPI_phoneGetID(
  HDRVPHONE   hdPhone,
  LPVARSTRING lpDeviceID,
  LPCWSTR     lpszDeviceClass,
  HANDLE      hTargetProcess
);

参数

hdPhone

要查询的电话的句柄。

lpDeviceID

指向 VARSTRING 类型的数据结构的指针，其中返回了设备标识符。 返回的信息的格式取决于设备类 (API) 用于命名设备的方法。 在调用 TSPI_phoneGetID 之前，应用程序会设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

lpszDeviceClass

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定请求其标识符的设备的设备类。

hTargetProcess

代表调用 TSPI_phoneGetID 函数的应用程序的进程句柄。 如果在 VARSTRING 结构中返回的信息包括供应用程序使用的句柄，则服务提供商将创建或复制进程的句柄。

返回值

如果函数成功，则返回零;如果发生错误，则返回错误号。 可能的返回值如下所示：

PHONEERR_INVALPHONEHANDLE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_OPERATIONFAILED、PHONEERR_NOMEM、PHONEERR_OPERATIONUNAVAIL。

注解

此操作可用于检索给定电话句柄的电话设备标识符。 它还可用于获取与打开的电话设备关联的设备类（例如 COM、波形、MIDI、电话、线路和 mciwave) ）的媒体设备 (的设备标识符。 然后，可以将此标识符与相应的媒体 API (（如 mci、midi 和 wav) ）一起使用，以选择相应的设备。 有关常见设备类名称的详细信息，请参阅 TSPI 设备类。

服务提供商填充 VARSTRING 数据结构的所有成员， dwTotalSize 除外，该成员由 TAPI 填充。 服务提供商不得覆盖 dwTotalSize 成员。

服务提供商无需处理 tapi/line 和 tapi/phone 设备类，因为 TAPI 为服务提供商处理这些类。 因此，用于处理这些设备类的代码是可选的。

要求

要求 值
目标平台 Windows
标头 tspi.h

另请参阅

VARSTRING