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

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

  • Статья

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

Синтаксис

LONG phoneSetHookSwitch(
  HPHONE hPhone,
  DWORD  dwHookSwitchDevs,
  DWORD  dwHookSwitchMode
);

Параметры

hPhone

Дескриптор на открытое телефонное устройство. Приложение должно быть владельцем телефона.

dwHookSwitchDevs

Устройство, для которого необходимо задать режим перехватчика. Этот параметр использует одну и только одну из констант PHONEHOOKSWITCHDEV_.

PHONEHOOKSWITCHDEV_HANDSET

Телефон телефона.

PHONEHOOKSWITCHDEV_SPEAKER

Громкой связи или адъюнкта телефона.

PHONEHOOKSWITCHDEV_HEADSET

Гарнитура телефона.

dwHookSwitchMode

Режим перехватчика для установки. Этот параметр использует одну и только одну из констант PHONEHOOKSWITCHMODE_.

PHONEHOOKSWITCHMODE_ONHOOK

Микрофон и динамик устройства являются перехватчиком.

PHONEHOOKSWITCHMODE_MIC

Микрофон устройства активен, динамик отключен.

PHONEHOOKSWITCHMODE_SPEAKER

Динамик устройства активен, микрофон отключен.

PHONEHOOKSWITCHMODE_MICSPEAKER

Микрофон и динамик устройства активны.

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

Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения PHONE_REPLY равен нулю, если функция завершается успешно, или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE PHONEERR_UNINITIALIZED.

Комментарии

Режим перехватчика одинаков для всех указанных устройств. Если нужны разные параметры, эту функцию можно вызывать несколько раз с другим набором параметров. Сообщение PHONE_STATE отправляется приложению после изменения состояния обработчика.

Требования

Требование Значение
Целевая платформа Windows
Header tapi.h
Библиотека Tapi32.lib
DLL Tapi32.dll

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

PHONE_REPLY

PHONE_STATE

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

Обзор справочника по TAPI 2.2