lineGetDevConfig 函数 (tapi.h)

项目
03/09/2024

lineGetDevConfig 函数返回一个“不透明”数据结构对象，其内容特定于行 (服务提供商) 和设备类。数据结构对象存储与线路设备关联的媒体流设备的当前配置。

语法

LONG lineGetDevConfig(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCSTR      lpszDeviceClass
);

参数

dwDeviceID

要配置的线路设备的标识符。

lpDeviceConfig

指向 VARSTRING 类型的内存位置的指针，其中返回了设备配置结构。成功完成请求后，此位置将填充设备配置。 VARSTRING 结构中的 dwStringFormat 成员设置为 STRINGFORMAT_BINARY。在调用 lineGetDevConfig 之前，应用程序必须设置此结构的 dwTotalSize 成员，以指示 TAPI 可用于返回信息的内存量。

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

lpszDeviceClass

指向以 null 结尾的字符串的指针，该字符串指定请求配置的设备的设备类。有效的设备类 lineGetID 字符串与为函数指定的字符串相同。

返回值

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

LINEERR_BADDEVICEID、LINEERR_NODRIVER、LINEERR_INVALDEVICECLASS、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALPOINTER、LINEERR_RESOURCEUNAVAIL、LINEERR_STRUCTURETOOSMALL、LINEERR_OPERATIONFAILED、LINEERR_NOMEM、LINEERR_UNINITIALIZED、LINEERR_NODEVICE。

注解

呼叫状态特定于设备。

lineGetDevConfig 函数可用于从 TAPI 检索数据结构，该结构指定与特定线路设备关联的媒体流设备的配置。例如，此结构的内容可以为与行关联的“datamodem”媒体设备指定数据速率、字符格式、调节方案和错误控制协议设置。

通常，应用程序调用 lineGetID 来标识与线路关联的媒体流设备，然后调用 lineConfigDialog 以允许用户设置设备配置。然后，它可以调用 lineGetDevConfig，并将配置信息保存在电话簿 (或与特定呼叫目标关联的其他数据库) 中。当用户稍后希望再次调用同一目标时，可以使用 lineSetDevConfig 还原用户选择的配置设置。可以按顺序使用函数 lineSetDevConfig、 lineConfigDialog 和 lineGetDevConfig ，以允许用户查看和更新设置。

结构中包含的数据的确切格式特定于行和媒体流 API (设备类) ，未记录且未定义。应用程序无法直接访问或操作此函数返回的结构，但只能保持不变地存储，以后在 lineSetDevConfig 中用于还原设置。结构也不一定可以传递给其他设备，即使同一个设备类 (尽管这在某些情况下可以正常工作，但不能保证) 。