Funzione phoneSetGain (tapi.h)

La funzione phoneSetGain imposta il guadagno del microfono del dispositivo hookswitch specificato al livello di guadagno specificato.

Sintassi

LONG phoneSetGain(
  HPHONE hPhone,
  DWORD  dwHookSwitchDev,
  DWORD  dwGain
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto. L'applicazione deve essere il proprietario del telefono.

dwHookSwitchDev

Dispositivo Hookswitch il cui guadagno del microfono deve essere impostato. Questo parametro usa una e una sola delle costanti PHONEHOOKSWITCHDEV_.

dwGain

Puntatore a una DWORD contenente la nuova impostazione di guadagno del dispositivo. Il parametro dwGain specifica il livello di guadagno del dispositivo hookswitch. Numero compreso nell'intervallo 0x00000000 (silenzio) per 0x0000FFFF (volume massimo). La granularità effettiva e la quantizzazione delle impostazioni di guadagno in questo intervallo sono specifiche del provider di servizi. Un valore per dwGain non compreso nell'intervallo è impostato sul valore più vicino nell'intervallo.

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_NOMEM, PHONEERR_NOTOWNER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALHOOKSWITCHDEV, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.

Requisiti

Vedi anche

PHONE_REPLY

Funzioni supplementari del servizio telefonico

Panoramica dei riferimenti a TAPI 2.2