función TSPI_phoneGetHookSwitch (tspi.h)
La función TSPI_phoneGetHookSwitch devuelve el modo hookswitch actual del dispositivo telefónico abierto especificado.
Sintaxis
LONG TSPIAPI TSPI_phoneGetHookSwitch(
HDRVPHONE hdPhone,
LPDWORD lpdwHookSwitchDevs
);
Parámetros
hdPhone
El identificador opaco del proveedor de servicios en el teléfono cuyo modo hookswitch se va a recuperar.
lpdwHookSwitchDevs
Puntero a una ubicación de tamaño DWORD en la que el proveedor de servicios escribe el modo de los dispositivos hookswitch del teléfono. Este parámetro usa una de las constantes PHONEHOOKSWITCHDEV_. Si una posición de bit es FALSE, el dispositivo hookswitch correspondiente es onhook. Si es TRUE, el micrófono o la parte del altavoz del dispositivo hookswitch correspondiente es offhook. Para averiguar si el micrófono o el altavoz están habilitados, TAPI puede usar TSPI_phoneGetStatus.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentarios
Una vez que cambia el estado de hookswitch de un dispositivo y si la supervisión de hookswitch está habilitada, TAPI se envía un mensaje de PHONE_STATE.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |