lineGetID 函数 (tapi.h)

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 可用于返回信息的内存量。

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

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、wave、MIDI、phone、line 或 NDIS) )的设备设备标识符或媒体设备 (。 然后,可以将此标识符与相应的 API ((例如电话、MIDI、波形) )一起使用,以选择与指定呼叫关联的相应媒体设备。

有关设备类名称 ,请参阅 TAPI 设备类

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

要求

   
目标平台 Windows
标头 tapi.h
Library Tapi32.lib
DLL Tapi32.dll

请参阅

基本电话服务参考

TAPI 2.2 参考概述

VARSTRING

lineOpen