Поделиться через


функция TSPI_phoneSetButtonInfo (tspi.h)

Функция TSPI_phoneSetButtonInfo задает сведения об указанной кнопке на указанном телефоне.

Синтаксис

LONG TSPIAPI TSPI_phoneSetButtonInfo(
  DRV_REQUESTID           dwRequestID,
  HDRVPHONE               hdPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Параметры

dwRequestID

Идентификатор асинхронного запроса. Поставщик услуг возвращает это значение, если функция выполняется асинхронно.

hdPhone

Дескриптор телефона, для которого необходимо задать сведения о кнопке.

dwButtonLampID

Кнопка на телефонном устройстве.

lpButtonInfo

Указатель на структуру изменяющегося размера типа PHONEBUTTONINFO. Эта структура данных описывает режим и функцию, а также предоставляет дополнительный описательный текст для кнопки.

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

Возвращает (положительное) значение dwRequestID , если функция выполняется асинхронно, или номер ошибки при возникновении ошибки. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM PHONEERR_OPERATIONUNAVAIL.

Комментарии

Эта функция задает значение и связанный описательный текст кнопок телефона.

Требования

Требование Значение
Целевая платформа Windows
Header tspi.h

См. также раздел

ASYNC_COMPLETION

PHONEBUTTONINFO

PHONECAPS

TSPI_phoneGetButtonInfo