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

Статья
08/26/2023

Функция lineSetMediaMode задает типы мультимедиа указанного вызова в своей структуре LINECALLINFO . Дополнительные сведения см. в разделе ITLegacyCallMediaControl::SetMediaType.

Синтаксис

LONG lineSetMediaMode(
  HCALL hCall,
  DWORD dwMediaModes
);

Параметры

hCall

Дескриптор вызова, тип носителя которого требуется изменить. Приложение должно быть владельцем вызова. Состояние вызова hCall может быть любым.

dwMediaModes

Новые типы мультимедиа для вызова. Этот параметр использует константы LINEMEDIAMODE_. Если установлен флаг неизвестного типа мультимедиа, можно также задать флаги других типов мультимедиа. Он используется для определения типа мультимедиа вызова как не полностью определенного, но сужается до одного из небольших наборов указанных типов мультимедиа. Если флаг UNKNOWN не задан, можно указать только один тип носителя.

Возвращаемое значение

Возвращает ноль, если запрос выполнен успешно, или отрицательный номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED LINEERR_OPERATIONUNAVAIL.

Функция lineSetMediaMode изменяет тип носителя вызова в структуре LINECALLINFO . Типичное использование этой операции заключается в том, чтобы задать тип носителя вызова для определенного известного типа мультимедиа или исключить возможные типы носителей, если тип носителя вызова официально неизвестен (установлен флаг типа носителя UNKNOWN).