Función phoneSetHookSwitch (tapi.h)

  • Artículo

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

Consulte también

PHONE_REPLY

PHONE_STATE

Funciones complementarias del servicio telefónico

Información general de referencia de TAPI 2.2