lineSetDevConfig 函数 (tapi.h)

项目
08/26/2023

lineSetDevConfig 函数允许应用程序将线路设备上的媒体流设备的配置还原为以前使用 lineGetDevConfig 获取的设置。例如，此结构的内容可以为与行关联的“datamodem”媒体设备指定数据速率、字符格式、调制方案和错误控制协议设置。

语法

LONG lineSetDevConfig(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

参数

dwDeviceID

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

lpDeviceConfig

指向 VARSTRING 结构的变量部分中 lineGetDevConfig 返回的不透明配置数据结构的指针。

dwSize

lpDeviceConfig 指向的结构中的字节数。此值在 lineGetDevConfig 返回的 VARSTRING 结构中的 dwStringSize 成员中返回。

lpszDeviceClass

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

返回值

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

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

注解

呼叫状态特定于设备。

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

结构中包含的数据的确切格式特定于线路和媒体流 API (设备类) ，未记录且未定义。应用程序必须将其视为“不透明”，而不是直接操作内容。通常，使用此函数只能将结构发送到从中获取它的同一设备。但是，某些电话服务提供商可能允许在同一设备之间交换结构， (即，同一个多端口调制解调器上的多个端口卡) 。无法以任何方式保证这种可互换性，即使对于同一设备类的设备也是如此。

某些服务提供商可能允许在调用处于活动状态时设置配置，而其他服务提供商可能不允许。