функция phoneGetDevCapsA (tapi.h)

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

Синтаксис

LONG phoneGetDevCapsA(
  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 или поставщика услуг несовместимы, и возвращается ошибка.

Заметка

Заголовок tapi.h определяет phoneGetDevCaps как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

PHONECAPS

дополнительных функций телефонной службы

Обзор TAPI 2.2

phoneNegotiateAPIVersion

phoneNegotiateExtVersion