функция TSPI_lineSetDefaultMediaDetection (tspi.h)
Процедура TSPI_lineSetDefaultMediaDetection сообщает поставщику службы, что новый набор типов носителей следует обнаружить для указанной строки (заменяя любой предыдущий набор). Он также задает начальный набор типов мультимедиа, которые должны отслеживаться при последующих вызовах (входящих или исходящих) в этой строке.
Синтаксис
LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
HDRVLINE hdLine,
DWORD dwMediaModes
);
Параметры
hdLine
Дескриптор строки для настройки мониторинга мультимедиа.
dwMediaModes
Типы мультимедиа, представляющие интерес для TAPI. Этот параметр использует одну из констант LINEMEDIAMODE_:
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER LINEERR_OPERATIONUNAVAIL.
Комментарии
TAPI обычно вызывает эту функцию, чтобы обновить набор обнаруженных типов мультимедиа для строки до объединения всех режимов, выбранных всеми необработанными lineOpens всякий раз, когда строка открыта или закрыта на уровне TAPI. Попытка вызова lineOpen отклоняется, если обнаружение мультимедиа отклонено. Один вызов этой процедуры обычно является результатом вызова lineOpen , который не указывает идентификатор устройства LINEMAPPER. Идентификатор устройства LINEMAPPER никогда не используется на уровне TSPI.
TAPI должен вычислить объединение типов носителей, требуемых для всех клиентов, и передать результат в эту функцию. Поставщик услуг использует набор, переданный в эту функцию с помощью TAPI. TAPI гарантирует, что параметр dwMediaModes имеет по крайней мере один бит и что зарезервированные биты не заданы. Поставщик услуг должен выполнять любые дальнейшие проверки допустимости для типов носителей, например проверять, действительно ли какие-либо типы носителей поддерживаются поставщиком услуг. Объединение всех типов мультимедиа может иметь значение 0, если все приложения с открытой строкой либо отслеживают, либо не заинтересованы в обработке входящих вызовов.
Непосредственно соответствующей функции на уровне TAPI нет. Эта процедура соответствует "типам носителей запросов", подразумеваемым для конкретной строки процедурой lineOpen , когда она вызывается с определенным идентификатором устройства (кроме LINEMAPPER).
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |