функция lineSetDevConfigA (tapi.h)

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

Синтаксис

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

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

Заметка

Заголовок tapi.h определяет lineSetDevConfig как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

Справочник по службам базовой телефонии

Обзор TAPI 2.2

VARSTRING

lineConfigDialog

lineGetDevConfig

lineGetID