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

Vedi anche

PHONE_REPLY

PHONE_STATE

Funzioni supplementari del servizio telefonico

Panoramica dei riferimenti a TAPI 2.2