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

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

Синтаксис

LONG lineGenerateDigitsW(
  HCALL   hCall,
  DWORD   dwDigitMode,
  LPCWSTR lpszDigits,
  DWORD   dwDuration
);

Параметры

hCall

Дескриптор вызова. Приложение должно быть владельцем вызова. Состояние вызова hCall может быть любым состоянием. TAPI не предъявляет никаких требований к состоянию вызова, однако некоторые поставщики услуг Tapi могут требовать, чтобы hCall был в состоянии LINECALLSTATE_CONNECTED.

dwDigitMode

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

lpszDigits

Указатель на буфер символов null-terminated, содержащий цифры, которые нужно создать. Допустимые символы — это те, которые указаны для LINEDIGITMODE_ констант, предоставленных в dwDigitModes.

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

Восклицательный знак (!) является допустимым символом. Этот символ вызывает операцию "hookflash", как описано для телефонных адресов.

dwDuration

Длительность в миллисекундах цифр DTMF и интервалов между цифрами DTMF и DTMF. Значение 0 использует значение по умолчанию. Параметр dwDuration должен находиться в диапазоне, указанном minDialParams и MaxDialParams в LINEDEVCAPS. Если не задан диапазон, фактическое значение имеет ближайшее значение в диапазоне.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDIGITMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Замечания

Функция lineGenerateDigits считается успешно завершенной при успешном запуске создания цифр, а не при создании всех цифр. В отличие от lineDial, который набирает цифры в сетевой зависимости, lineGenerateDigits гарантирует, что цифры, как инбандовые тоны по каналу голосовой связи с помощью DTMF или крючок набора импульсов при использовании пульса. Функция lineGenerateDigits обычно не подходит для вызова или набора номера. Он предназначен для сквозного сигнала по установленному вызову.

После создания всех цифр в lpszDigits или после прерывания или отмены создания цифр в приложение отправляется сообщение LINE_GENERATE.

Для всех приложений, которые являются владельцами вызова, разрешено выполнять только один запрос на создание тонов (поколение тонов или поколение цифр). Создание цифр при вызове отменяется путем инициирования другого запроса на создание цифр или запроса на создание тонов. Чтобы отменить текущее поколение цифр, приложение может вызвать lineGenerateDigits и указать NULL для параметра lpszDigits.

В зависимости от поставщика услуг и оборудования приложение может отслеживать цифры, которые он создает. Если это не нужно, приложение может отключить мониторинг цифр при создании цифр.

Заметка

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

Требования

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

См. также

LINEDEVCAPS

LINE_GENERATE

дополнительных функций службы

Обзор TAPI 2.2

lineDial

lineGenerateTone

  • Last updated on