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

Статья
03/13/2024

Функция TSPI_lineOpen открывает устройство строки, идентификатор которого задан, возвращая дескриптор поставщика услуг для устройства. Поставщик услуг должен сохранить дескриптор TAPI для устройства для использования в последующих вызовах процедуры обратного вызова LINEEVENT .

Синтаксис

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

Параметры

dwDeviceID

Идентифицирует открывающееся линейное устройство.

htLine

Дескриптор TAPI для линейного устройства, который будет использоваться в последующих вызовах процедуры обратного вызова LINEEVENT для идентификации устройства.

lphdLine

Указатель на HDRVLINE , где поставщик услуг заполняет свой дескриптор для линейного устройства.

dwTSPIVersion

Версия TSPI.

lpfnEventProc

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

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

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

LINEERR_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.

Поставщик услуг должен зарезервировать все ресурсы без общего доступа, необходимые для управления строкой. Однако все действия, которые можно отложить в lineMakeCall , должны быть. В TAPI предполагается, что lineOpen является "недорогой" операцией. Например, если строка открывается только в режиме мониторинга, поставщику услуг на основе порта COMM не нужно открывать порт COMM.

Эта процедура не соответствует непосредственно какой-либо процедуре на уровне TAPI, в которой функции включения расширений для конкретного устройства, выбора характеристик строки и определения типов мультимедиа включаются в функции , определенные lineOpen. На уровне TSPI эти дополнительные возможности разделяются на TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection и TSPI_lineConditionalMediaDetection.