phoneGetID 函数返回与指定电话设备关联的给定设备类的设备标识符。
语法
LONG phoneGetIDA(
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、波形、MIDI、电话、线路或 NDIS）的设备标识符。 这些设备类的名称不区分大小写。 然后，可以将此标识符与相应的媒体 API 一起使用，以选择相应的设备。
有关设备类名称，请参阅 TAPI 设备类。
定义特定于设备的媒体类型的供应商还需要定义相应的特定于设备的（专有）API 来管理媒体类型的设备。 为了避免不同供应商单独分配的设备类名称发生冲突，供应商应选择一个唯一标识供应商的名称，并在该名称之后选择媒体类型。 例如：“intel/video”。
注意
tapi.h 标头将 phoneGetID 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 窗户 |
| 标头 | tapi.h |
| 库 | Tapi32.lib |
| DLL | Tapi32.dll |