Función phoneGetHookSwitch (tapi.h)

Artículo
03/08/2023

La función phoneGetHookSwitch devuelve el modo hookswitch actual del dispositivo de teléfono abierto especificado.

Sintaxis

LONG phoneGetHookSwitch(
  HPHONE  hPhone,
  LPDWORD lpdwHookSwitchDevs
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto.

lpdwHookSwitchDevs

Puntero a un DWORD que se va a rellenar con el modo de los dispositivos hookswitch del teléfono. 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, la aplicación puede usar phoneGetStatus. Este parámetro usa una o varias de las constantes de PHONEHOOKSWITCHDEV_.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Comentarios

Una vez que cambia el estado de hookswitch de un dispositivo y si la supervisión de hookswitch está habilitada, la aplicación se envía un mensaje de PHONE_STATE .