функция TSPI_phoneGetButtonInfo (tspi.h)
Функция TSPI_phoneGetButtonInfo возвращает сведения об указанной кнопке.
Синтаксис
LONG TSPIAPI TSPI_phoneGetButtonInfo(
HDRVPHONE hdPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO lpButtonInfo
);
Параметры
hdPhone
Дескриптор запрашиваемого телефона.
dwButtonLampID
Кнопка на телефонном устройстве.
lpButtonInfo
Указатель на память, в которую поставщик услуг записывает структуру с переменным размером типа PHONEBUTTONINFO. Эта структура данных описывает режим и функцию, а также предоставляет дополнительный описательный текст, соответствующий кнопке. Перед вызовом TSPI_phoneGetButtonInfo приложение задает член dwTotalSize этой структуры, чтобы указать объем памяти, доступный ДЛЯ TAPI для возврата сведений.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL PHONEERR_NOMEM.
Комментарии
Функция TSPI_phoneGetButtonInfo возвращает значение PHONEERR_NOMEM, если поставщик услуг не может получить доступ к памяти, содержащей сведения о кнопке.
Поставщик услуг заполняет все элементы структуры данных PHONEBUTTONINFO , за исключением dwTotalSize, которая заполняется с помощью TAPI. Поставщик услуг не должен перезаписывать член dwTotalSize .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |