функция TSPI_phoneGetDevCaps (tspi.h)
Функция TSPI_phoneGetDevCaps запрашивает указанное телефонное устройство, чтобы определить его возможности телефонии.
Синтаксис
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
Параметры
dwDeviceID
Запрашиваемая телефонная устройство.
dwTSPIVersion
Согласованный номер версии TSPI. Это значение согласовывается для этого устройства с помощью функции TSPI_phoneNegotiateTSPIVersion .
dwExtVersion
Согласованный номер версии расширения. Это значение согласовывается для этого устройства с помощью функции TSPI_phoneNegotiateExtVersion .
lpPhoneCaps
Указатель на память, в которую поставщик услуг записывает структуру с переменным размером типа PHONECAPS. После успешного выполнения запроса эта структура заполняется сведениями о возможностях телефонного устройства. Перед вызовом TSPI_phoneGetDevCaps приложение задает элемент dwTotalSize этой структуры, чтобы указать объем памяти, доступный ДЛЯ TAPI для возврата сведений.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL PHONEERR_NOMEM.
Комментарии
Поставщик услуг заполняет все элементы структуры данных PHONEBUTTONINFO , за исключением dwTotalSize, которая заполняется с помощью TAPI. Поставщик услуг не должен перезаписывать член dwTotalSize .
Если dwExtVersion равно нулю, сведения о расширении не запрашивается. Если это ненулевое значение, оно содержит значение, которое уже согласовано для этого устройства с помощью функции TSPI_phoneNegotiateExtVersion . Поставщик услуг заполняет расширенные сведения о конкретном устройстве и поставщике в соответствии с указанной версией расширения.
После возврата поставщика услуг из функции TSPI_phoneGetDevCaps TAPI задает член dwPhoneStates структуры PHONECAPS следующим образом:
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | tspi.h |