lineGetID 函数 (tapi.h)

项目
03/05/2024

lineGetID 函数返回与所选线路、地址或调用关联的指定设备类的设备标识符。

语法

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

参数

hLine

开行设备的句柄。

dwAddressID

给定开行设备上的地址。地址标识符与地址永久关联;标识符在操作系统升级中保持不变。

hCall

调用的句柄。

dwSelect

指定请求的设备标识符是与线路、地址还是单个呼叫相关联。此参数使用一个且只使用一个 LINECALLSELECT_常量。

lpDeviceID

指向 VARSTRING 类型的内存位置的指针，其中返回了设备标识符。成功完成请求后，此位置将填充设备标识符。返回信息的格式取决于设备类 API 用于命名设备的方法。在调用 lineGetID 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

注意如果结构中的 size 参数不正确，则有可能覆盖数据。有关设置结构大小的详细信息，请参阅内存分配主题。

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 函数可用于检索行设备标识符。使用 LINEMAPPER 作为设备标识符打开 lineOpen 后，这非常有用，以便确定打开的行的实际行设备标识符。此函数还可用于获取与呼叫、地址或线路关联的设备类（如 COM、波形、MIDI、电话、线路或 NDIS) ）的电话设备或媒体设备 (的设备标识符。然后，可以将此标识符与相应的 API (（如电话、MIDI、波形) ）一起使用，以选择与指定呼叫关联的相应媒体设备。

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

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