функция TSPI_phoneOpen (tspi.h)
Функция TSPI_phoneOpen открывает телефонное устройство, идентификатор которого задан, возвращая непрозрачный дескриптор поставщика услуг для устройства и сохраняя непрозрачный дескриптор TAPI для устройства для использования в последующих вызовах процедуры PHONEEVENT .
Синтаксис
LONG TSPIAPI TSPI_phoneOpen(
DWORD dwDeviceID,
HTAPIPHONE htPhone,
LPHDRVPHONE lphdPhone,
DWORD dwTSPIVersion,
PHONEEVENT lpfnEventProc
);
Параметры
dwDeviceID
Открывающееся телефонное устройство.
htPhone
Непрозрачный дескриптор TAPI для телефонного устройства, который будет использоваться в последующих вызовах процедуры обратного вызова PHONEEVENT для идентификации устройства.
lphdPhone
Указатель на HDRVPHONE , где поставщик услуг записывает свой дескриптор для телефонного устройства, используемого TAPI в последующих вызовах для идентификации устройства.
dwTSPIVersion
Версия TSPI согласовывается с помощью TSPI_phoneNegotiateTSPIVersion , с которыми может работать поставщик услуг.
lpfnEventProc
Указатель на процедуру обратного вызова PHONEEVENT , предоставляемую TAPI, которую поставщик услуг вызывает для сообщения о последующих событиях на телефоне.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL PHONEERR_INIFILECORRUPT.
Комментарии
Открытие телефона дает возможность TAPI делать дальнейшие запросы по телефону. Телефон становится активным в том смысле, что поставщик услуг может сообщать об асинхронных событиях, таких как изменения перехватчика или нажатия кнопок. Поставщик услуг резервирует все неуправляемые ресурсы, необходимые для управления телефоном. Например, открытие телефона, доступ к которым осуществляется через порт comm и модем, должен привести к открытию порта comm, что сделает его недоступным для использования другими приложениями.
Если функция выполняется успешно, TAPI и поставщик услуг станут привержены работе с указанным номером версии интерфейса для этого открытого устройства. Последующие операции и события, выявленные с помощью обменяемых непрозрачных дескрипторов телефона, соответствуют этой версии интерфейса. Это обязательство и срок действия дескрипторов остаются в силе до тех пор, пока TAPI не закроет телефон с помощью TSPI_phoneClose или пока поставщик услуг не сообщит о событии PHONE_CLOSE . Если функция не выполнена, такое обязательство не выполняется, а дескрипторы недопустимы.
Требования
| Целевая платформа | Windows |
| Header | tspi.h |