Функция lineSetDevConfig (tapi.h)

Статья
08/26/2023

Функция lineSetDevConfig позволяет приложению восстановить конфигурацию устройства потока мультимедиа на устройстве линии до конфигурации, ранее полученной с помощью lineGetDevConfig. Например, содержимое этой структуры может указывать скорость передачи данных, формат символов, схемы модуляции и параметры протокола управления ошибками для устройства мультимедиа datamodem, связанного со строкой.

Синтаксис

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

Параметры

dwDeviceID

Идентификатор настраиваемого линейного устройства.

lpDeviceConfig

Указатель на непрозрачную структуру данных конфигурации, возвращенную lineGetDevConfig в переменной части структуры VARSTRING .

dwSize

Число байтов в структуре, на которую указывает lpDeviceConfig. Это значение возвращается в элементе dwStringSize в структуре VARSTRING , возвращаемой lineGetDevConfig.

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 потока строк и медиапотока (класс устройства), не является документированием и не определен. Приложение должно рассматривать его как "непрозрачное" и не управлять содержимым напрямую. Как правило, структура может быть отправлена с помощью этой функции только на то же устройство, с которого она была получена. Однако некоторые поставщики услуг телефонии могут разрешать обмен структурами между идентичными устройствами (т. е. несколькими портами на одном многопортовом модеме карта). Такая взаимозаменяемость не гарантируется ни в коем случае, даже для устройств одного класса устройств.

Некоторые поставщики услуг могут разрешить настройку конфигурации при активном вызове, а другие — нет.