phoneGetID 函数 (tapi.h)

项目
03/02/2024

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

语法

LONG phoneGetID(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

参数

hPhone

打开的手机设备的句柄。

lpDeviceID

指向 VARSTRING 类型的数据结构的指针，其中返回了设备标识符。成功完成请求后，此位置将填充设备标识符。返回信息的格式取决于设备类 (API) 用于命名设备的方法。

lpszDeviceClass

指向以 null 结尾的字符串的指针，该字符串指定请求其标识符的设备的设备类。有效的设备类字符串是在 System.ini 部分中用于标识设备类的字符串。

返回值

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALDEVICECLASS、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONFAILED、PHONEERR_STRUCTURETOOSMALL PHONEERR_OPERATIONUNAVAIL。

注解

phoneGetID 函数可用于检索给定电话句柄的电话设备标识符。它还可用于获取与打开的电话设备关联的设备类（例如 COM、wave、MIDI、电话、线路或 NDIS) ） (媒体设备的设备标识符。这些设备类的名称不区分大小写。然后，可以将此标识符与相应的媒体 API 一起使用，以选择相应的设备。

有关设备类名称，请参阅 TAPI 设备类。

定义特定于设备的媒体类型的供应商还需要定义相应的特定于设备的 (专有) API 来管理媒体类型的设备。为避免不同供应商独立分配的设备类名称发生冲突，供应商应选择一个唯一标识供应商的名称，并在其后唯一标识媒体类型。例如：“intel/video”。