Función phoneSetHookSwitch (tapi.h)
La función phoneSetHookSwitch establece el estado de enlace de los dispositivos hookswitch del teléfono abierto especificados en el modo especificado. Solo se ve afectado el estado de hookswitch de los dispositivos hookswitch enumerados.
Sintaxis
LONG phoneSetHookSwitch(
HPHONE hPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
Parámetros
hPhone
Controle el dispositivo de teléfono abierto. La aplicación debe ser el propietario del teléfono.
dwHookSwitchDevs
Dispositivo cuyo modo hookswitch se va a establecer. Este parámetro usa una y solo una de las PHONEHOOKSWITCHDEV_ Constantes.
PHONEHOOKSWITCHDEV_HANDSET
El teléfono del teléfono.
PHONEHOOKSWITCHDEV_SPEAKER
El altavoz o el adjunto del teléfono.
PHONEHOOKSWITCHDEV_HEADSET
Auriculares del teléfono.
dwHookSwitchMode
Modo hookswitch que se va a establecer. Este parámetro usa una y solo una de las constantes de PHONEHOOKSWITCHMODE_.
PHONEHOOKSWITCHMODE_ONHOOK
El micrófono y el altavoz del dispositivo son tanto onhook.
PHONEHOOKSWITCHMODE_MIC
El micrófono del dispositivo está activo, el altavoz está silenciado.
PHONEHOOKSWITCHMODE_SPEAKER
El altavoz del dispositivo está activo, el micrófono está silenciado.
PHONEHOOKSWITCHMODE_MICSPEAKER
El micrófono y el altavoz del dispositivo están activos.
Valor devuelto
Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de PHONE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED.
Comentarios
El modo hookswitch es el mismo para todos los dispositivos especificados. Si se desea una configuración diferente, esta función se puede invocar varias veces con un conjunto diferente de parámetros. Se envía un mensaje PHONE_STATE a la aplicación después de cambiar el estado de hookswitch.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |