funzione phoneGetHookSwitch (tapi.h)

Articolo
03/13/2024

La funzione phoneGetHookSwitch restituisce la modalità hookswitch corrente del dispositivo telefonico aperto specificato.

Sintassi

LONG phoneGetHookSwitch(
  HPHONE  hPhone,
  LPDWORD lpdwHookSwitchDevs
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto.

lpdwHookSwitchDevs

Puntatore a un DWORD da riempire con la modalità dei dispositivi hookswitch del telefono. Se una posizione di bit è FALSE, il dispositivo hookswitch corrispondente è onhook; se TRUE, la parte del microfono e/o dell'altoparlante del dispositivo hookswitch corrispondente è offhook. Per scoprire se il microfono e/o l'altoparlante sono abilitati, l'applicazione può usare phoneGetStatus. Questo parametro usa una o più costanti PHONEHOOKSWITCHDEV_.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

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

Commenti

Dopo la modifica dello stato hookswitch di un dispositivo e se il monitoraggio hookswitch è abilitato, l'applicazione viene inviato un messaggio di PHONE_STATE .