lineSetDevConfigA 函数（tapi.h）

2024-11-20

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

语法

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

参数

dwDeviceID

要配置的行设备的标识符。

lpDeviceConfig

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

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（设备类），未记录，并且未定义。应用程序必须将其视为“不透明”，而不是直接操作内容。通常，可以使用此函数将结构发送到从中获取它的同一设备。但是，某些电话服务提供商可能允许在同一设备之间交换结构（即同一多端口调制解调器卡上的多个端口）。即使对于同一设备类的设备，这种可互换性也不保证。

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

注意

tapi.h 标头将 lineSetDevConfig 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。