Функция lineGetDevCaps (tapi.h)

Статья
08/26/2023

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

Синтаксис

LONG lineGetDevCaps(
  HLINEAPP      hLineApp,
  DWORD         dwDeviceID,
  DWORD         dwAPIVersion,
  DWORD         dwExtVersion,
  LPLINEDEVCAPS lpLineDevCaps
);

Параметры

hLineApp

Обработка регистрации приложения с помощью TAPI.

dwDeviceID

Идентификатор запрашиваемого линейного устройства.

dwAPIVersion

Номер версии используемого API телефонии. Слово высокого порядка содержит основной номер версии; Слово нижнего порядка содержит дополнительный номер версии. Это число получается с помощью lineNegotiateAPIVersion.

dwExtVersion

Номер версии используемых расширений поставщика услуг. Это число получается с помощью lineNegotiateExtVersion. Его можно оставить нулевым, если не требуется использовать расширения для конкретного устройства. В противном случае слово высокого порядка содержит основной номер версии; Слово нижнего порядка содержит дополнительный номер версии.

lpLineDevCaps

Указатель на структуру изменчивого размера типа LINEDEVCAPS. После успешного выполнения запроса эта структура заполняется сведениями о возможностях линейного устройства. Перед вызовом lineGetDevCaps приложение должно задать член dwTotalSize этой структуры, чтобы указать объем памяти, доступный ДЛЯ TAPI для возврата сведений.

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе о выделении памяти .

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

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

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALAPPHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL LINEERR_NODEVICE.

Номера версий API и расширений — это номера, под которыми должны работать TAPI и поставщик услуг. Если диапазоны версий не перекрываются, версии приложения, API или поставщика услуг несовместимы и возвращается ошибка.

Один из элементов в структуре LINEDEVCAPS , возвращаемой этой функцией, содержит количество адресов, назначенных указанному устройству линии. Фактические идентификаторы адресов, используемые для ссылки на отдельные адреса, варьируются от нуля до единицы меньше возвращаемого числа. Возможности каждого адреса могут быть разными. Используйте lineGetAddressCaps Для каждого доступного < сочетания dwDeviceID и dwAddressID>, чтобы определить точные возможности каждого адреса. Обратите внимание, что идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.