lineGetDevConfigW 函数（tapi.h）

2024-11-20

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

语法

LONG lineGetDevConfigW(
  DWORD       dwDeviceID,
  LPVARSTRING lpDeviceConfig,
  LPCWSTR     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 中完整存储，稍后才能还原设置。结构也不一定传递给其他设备，即使是同一设备类（尽管这在某些情况下可以正常工作，但不能保证）。

注意

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