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

Статья
03/13/2024

TAPI вызывает функцию TSPI_providerEnumDevices перед TSPI_providerInit , чтобы определить количество телефонных и линейных устройств, поддерживаемых поставщиком услуг.

Синтаксис

LONG TSPIAPI TSPI_providerEnumDevices(
  DWORD      dwPermanentProviderID,
  LPDWORD    lpdwNumLines,
  LPDWORD    lpdwNumPhones,
  HPROVIDER  hProvider,
  LINEEVENT  lpfnLineCreateProc,
  PHONEEVENT lpfnPhoneCreateProc
);

Параметры

dwPermanentProviderID

Постоянный идентификатор инициализируемого поставщика услуг, уникальный в пределах поставщиков услуг в этой системе.

lpdwNumLines

Указатель на расположение памяти размера DWORD, в которое поставщик услуг должен записать количество устройств строки, для поддержки которых он настроен. TAPI инициализирует значение 0, поэтому если поставщику услуг не удается записать другое значение, предполагается значение 0.

lpdwNumPhones

Указатель на расположение памяти размера DWORD, в которое поставщик услуг должен записать количество телефонных устройств, для поддержки которых он настроен. TAPI инициализирует значение 0, поэтому если поставщику услуг не удается записать другое значение, предполагается значение 0.

hProvider

Непрозрачное значение размера DWORD, которое однозначно идентифицирует данный экземпляр этого поставщика услуг во время выполнения среды телефонии.

lpfnLineCreateProc

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

lpfnPhoneCreateProc

Указатель на процедуру обратного вызова PHONEEVENT , предоставляемую TAPI. Поставщик услуг использует эту функцию для отправки PHONE_CREATE сообщений при необходимости создания нового телефонного устройства.

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

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

LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

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

Новое устройство может появиться до завершения процедуры TSPI_providerInit . TAPI правильно обрабатывает все сообщения _CREATE во время инициализации поставщика.