Функция обратного вызова PHONEEVENT (tspi.h)
Phone_Event функция обратного вызова, реализованная TAPI и предоставляемая поставщику услуг в качестве параметра для TSPI_phoneOpen. Поставщик услуг вызывает эту функцию, чтобы сообщить о событиях, происходящих на телефоне.
Тип PHONEEVENT определяет указатель на эту функцию обратного вызова. Phone_Event — это заполнитель для имени функции, определяемой приложением.
Синтаксис
PHONEEVENT Phoneevent;
void Phoneevent(
HTAPIPHONE htPhone,
DWORD dwMsg,
DWORD_PTR dwParam1,
DWORD_PTR dwParam2,
DWORD_PTR dwParam3
)
{...}
Параметры
htPhone
Дескриптор TAPI для телефона, на котором произошло событие.
dwMsg
Указывает тип события, о котором сообщается. Интерпретация других параметров выполняется различными способами в соответствии с контекстом, указанным dwMsg.
dwParam1
Параметр для сообщения.
dwParam2
Параметр для сообщения.
dwParam3
Параметр для сообщения.
Возвращаемое значение
None
Remarks
Состояние вызова при вызове этой функции может быть любым.
Поставщик услуг передает значение HTAPIPHONE , предоставленное TSPI_phoneOpen в качестве параметра htPhone . Он включает идентификатор сообщения и параметры, относящиеся к событию.
Наборы сообщений, которые могут быть переданы в эту процедуру, немного отличаются от сообщений для соответствующего обратного вызова на уровне TAPI. В частности, о завершении асинхронного выполнения запросов сообщается через обратный вызов Completion_Proc вместо этого.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |