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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |