Функция 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 |