funzione phoneSetVolume (tapi.h)
La funzione phoneSetVolume imposta il volume del componente altoparlante del dispositivo hookswitch specificato al livello specificato.
Sintassi
LONG phoneSetVolume(
HPHONE hPhone,
DWORD dwHookSwitchDev,
DWORD dwVolume
);
Parametri
hPhone
Gestire il dispositivo telefono aperto. L'applicazione deve essere il proprietario del telefono.
dwHookSwitchDev
Dispositivo Hookswitch il cui volume dell'altoparlante deve essere impostato, uno dei costanti PHONEHOOKSWITCHDEV_.
dwVolume
Nuova impostazione del volume del dispositivo. Il parametro dwVolume specifica il livello del volume del dispositivo hookswitch. Questo è un numero nell'intervallo 0x00000000 (silenzio) per 0x0000FFFF (volume massimo). La granularità effettiva e la quantizzazione delle impostazioni del volume in questo intervallo sono specifiche del provider di servizi. Un valore per dwVolume 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 un numero di errore 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 |