Funzione phoneSetHookSwitch (tapi.h)
La funzione phoneSetHookSwitch imposta lo stato hook dei dispositivi hookswitch del telefono aperto specificati alla modalità specificata. Solo lo stato hookswitch dei dispositivi hookswitch elencati è interessato.
Sintassi
LONG phoneSetHookSwitch(
HPHONE hPhone,
DWORD dwHookSwitchDevs,
DWORD dwHookSwitchMode
);
Parametri
hPhone
Gestire il dispositivo telefonico aperto. L'applicazione deve essere il proprietario del telefono.
dwHookSwitchDevs
Dispositivo la cui modalità hookswitch deve essere impostata. Questo parametro usa una e una sola delle costanti PHONEHOOKSWITCHDEV_.
PHONEHOOKSWITCHDEV_HANDSET
Il ricevitore del telefono.
PHONEHOOKSWITCHDEV_SPEAKER
L'altoparlante o l'aggiunta del telefono.
PHONEHOOKSWITCHDEV_HEADSET
Visore VR del telefono.
dwHookSwitchMode
Modalità Hookswitch da impostare. Questo parametro usa una e una sola delle costanti PHONEHOOKSWITCHMODE_.
PHONEHOOKSWITCHMODE_ONHOOK
Il microfono e l'altoparlante del dispositivo sono entrambi onhook.
PHONEHOOKSWITCHMODE_MIC
Il microfono del dispositivo è attivo, l'altoparlante è disattivato.
PHONEHOOKSWITCHMODE_SPEAKER
L'altoparlante del dispositivo è attivo, il microfono è disattivato.
PHONEHOOKSWITCHMODE_MICSPEAKER
Il microfono e l'altoparlante del dispositivo sono entrambi attivi.
Valore restituito
Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o negativo se si verifica un errore. Il parametro dwParam2 del messaggio di PHONE_REPLY corrispondente è zero se la funzione ha esito positivo o è un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALHOOKSWITCHMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED.
Commenti
La modalità hookswitch è la stessa per tutti i dispositivi specificati. Se si desiderano impostazioni diverse, questa funzione può essere richiamata più volte con un set diverso di parametri. Un messaggio di PHONE_STATE viene inviato all'applicazione dopo la modifica dello stato hookswitch.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |