функция TSPI_lineGenerateDigits (tspi.h)

Статья
08/26/2023

Функция TSPI_lineGenerateDigits инициирует создание указанных цифр в указанном вызове в виде тонов по каналу с использованием указанного режима сигнализации. Вызов этой функции во время создания цифр или тона прерывает создание текущей цифры или тона. Передача значения NULL для lpsDigits не приводит к созданию новых цифр.

Примечание Для каждого вызова может выполняться только один запрос на создание сигналов (генерация сигналов или цифр).

Синтаксис

LONG TSPIAPI TSPI_lineGenerateDigits(
  HDRVCALL hdCall,
  DWORD    dwEndToEndID,
  DWORD    dwDigitMode,
  LPCWSTR  lpszDigits,
  DWORD    dwDuration
);

Параметры

hdCall

Дескриптор вызова, для которого необходимо выполнить создание цифр.

dwEndToEndID

Этот уникальный идентификатор запроса должен храниться поставщиком услуг и передаваться обратно как dwParam2 в процедуру LINEEVENT после завершения создания цифр.

dwDigitMode

Формат, используемый для сигнализации этих цифр. Этот параметр использует одну и только одну из констант LINEDIGITMODE_.

lpszDigits

Указатель на буфер символов Юникода, завершающийся нулевым значением, который содержит создаваемые цифры. Запятая вводит дополнительную задержку между сигналами предыдущей и следующей цифр, которые она разделяет. Длительность этой паузы определяется конфигурацией. Возможности устройства в строке указывают, каково это время. Для вставки более длительных пауз можно использовать несколько запятых. Недопустимые цифры игнорируются во время создания, а не сообщаются как об ошибке.

dwDuration

Указывает длительность (в миллисекундах) цифр DTMF и интервалы между цифрами DTMF и интервалы между цифрами DTMF. Значение 0 использует значение по умолчанию. Параметр dwDuration должен находиться в диапазоне, указанном в параметре MinDialParams и MaxDialParams в LINEDEVCAPS. Если диапазон выходит за пределы диапазона, фактическое значение устанавливается поставщиком услуг в качестве ближайшего значения в диапазоне. Этот параметр не проверяется TAPI при вызове этой функции.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL LINEERR_RESOURCEUNAVAIL.

Примечание Для каждого вызова может выполняться только один запрос на создание по полосе (генерация сигналов или цифр). Это означает, что если при вызове выполняется создание цифр, вызов TSPI_lineGenerateDigits или TSPI_lineGenerateTone отменяет создание цифр. Поставщик услуг должен завершить любое генерацию цифр при вызове последующего TSPI_lineGenerateDigits или TSPI_lineGenerateTone . Вызов TSPI_lineGenerateDigits с параметром lpszDigits , имеющим значение NULL , отменяет создание любой текущей цифры (или тона).

Соответствующая функция на уровне TAPI не включает формальный параметр dwEndToEndID. На этом уровне нет сквозной маркировки. TAPI использует сквозную маркировку на уровне TSPI для устранения неоднозначности одного TSPI_lineGenerateDigits запроса от другого.