lineGetID 函数返回与所选行、地址或调用关联的指定设备类的设备标识符。
语法
LONG lineGetIDA(
HLINE hLine,
DWORD dwAddressID,
HCALL hCall,
DWORD dwSelect,
LPVARSTRING lpDeviceID,
LPCSTR lpszDeviceClass
);
参数
hLine
打开的线路设备的句柄。
dwAddressID
给定的开放行设备上的地址。 地址标识符永久关联到地址;标识符在操作系统升级中保持不变。
hCall
调用句柄。
dwSelect
指定请求的设备标识符是与行、地址还是单个调用相关联。 此参数只使用一个常量
lpDeviceID
指向 VARSTRING类型的内存位置的指针，其中返回了设备标识符。 成功完成请求后，此位置将填充设备标识符。 返回的信息的格式取决于设备类 API 用于命名设备的方法。 在调用 lineGetID之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。
注意 如果结构中的大小参数不正确，则有可能覆盖数据。 有关设置结构大小的详细信息，请参阅 内存分配 主题。
lpszDeviceClass
指向以 null 结尾的字符串的指针，该字符串指定请求其标识符的设备的设备类。 有效的设备类字符串是在 SYSTEM 中使用的字符串。用于标识设备类的 INI 部分。
返回值
如果请求成功，则返回零;如果发生错误，则返回负错误号。 可能的返回值为：
LINEERR_INVALLINEHANDLE、LINEERR_NOMEM、LINEERR_INVALADDRESSID、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONFAILED、LINEERR_INVALCALLSELECT、LINEERR_INVALDEVICECLASS、LINEERR_RESOURCEUNAVAIL、LINEERR_INVALPOINTER、LINEERR_STRUCTURETOOSMALL、LINEERR_NODEVICE、LINEERR_UNINITIALIZED。
言论
给定行句柄时，可以使用 lineGetID 函数来检索行设备标识符。 这在 lineOpen 已使用 LINEMAPPER 作为设备标识符打开后非常有用，以便确定打开的行的实际行设备标识符。 此函数还可用于获取与呼叫、地址或线路关联的电话设备或媒体设备（例如 COM、波形、MIDI、电话、线路或 NDIS）的设备标识符。 然后，此标识符可以与相应的 API（如手机、MIDI、波形）一起使用，以选择与指定呼叫关联的相应媒体设备。
有关设备类名称，请参阅 TAPI 设备类。
定义特定于设备的媒体模式的供应商还需要定义相应的特定于设备的（专有）API 来管理媒体模式的设备。 为了避免不同供应商单独分配的设备类名称发生冲突，供应商应选择一个唯一标识供应商的名称，并在该名称之后选择媒体类型。 例如：“intel/video”。
注意
tapi.h 标头将 lineGetID 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 窗户 |
| 标头 | tapi.h |
| 库 | Tapi32.lib |
| DLL | Tapi32.dll |