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

Статья
08/26/2023

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

Синтаксис

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Параметры

hPhoneApp

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

dwDeviceID

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

dwAPIVersion

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

dwExtVersion

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

lpPhoneCaps

Указатель на структуру изменчивого размера типа PHONECAPS. После успешного выполнения запроса эта структура заполняется сведениями о возможностях телефонного устройства.

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

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

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED PHONEERR_NODEVICE.

Перед использованием phoneGetDevCaps приложение должно согласовать номер версии TAPI для использования (см. phoneNegotiateAPIVersion) и, при необходимости, версию расширения для использования (см. phoneNegotiateExtVersion).

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