Поделиться через

Функция обратного вызова LINEEVENT (tspi.h)

  • Статья

Line_Event — это функция обратного вызова, реализованная TAPI и предоставляемая поставщику услуг в качестве параметра для TSPI_lineOpen. Поставщик услуг вызывает эту функцию, чтобы сообщить о событиях, происходящих в строке или при вызовах в строке.

Тип LINEEVENT определяет указатель на эту функцию обратного вызова. Line_Event — это заполнитель для имени функции, определяемой приложением.

Синтаксис

LINEEVENT Lineevent;

void Lineevent(
  HTAPILINE htLine,
  HTAPICALL htCall,
  DWORD dwMsg,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2,
  DWORD_PTR dwParam3
)
{...}

Параметры

htLine

Дескриптор TAPI для строки, в которой произошло событие.

htCall

Дескриптор TAPI для вызова, в котором произошло событие, если это событие, связанное с вызовом. Для событий, связанных со строкой, в которых нет вызова, этому параметру присваивается значение NULL.

dwMsg

Указывает тип события, о котором сообщается. Интерпретация других параметров выполняется различными способами в соответствии с контекстом, указанным dwMsg.

dwParam1

Параметр для сообщения.

dwParam2

Параметр для сообщения.

dwParam3

Параметр для сообщения.

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

None

Remarks

Состояние вызова при вызове этой функции может быть любым.

Поставщик услуг передает значение HTAPILINE , предоставленное TSPI_lineOpen в качестве параметра htLine . Он включает идентификатор сообщения и параметры, относящиеся к событию.

Эта функция отличается от функции обратного вызова, определенной на уровне TAPI, тем, что она разделяет параметры строки и вызова. Оба параметра используются для некоторых сообщений. Наборы сообщений, которые могут быть переданы в эту процедуру, немного отличаются от уровня TAPI. В частности, о завершении асинхронного выполнения запросов сообщается через обратный вызов Completion_Proc вместо этого.

Требования

Требование Значение
Целевая платформа Windows
Header tspi.h

См. также раздел

Completion_Proc

TSPI_lineOpen