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

Vedi anche

PHONE_REPLY

Funzioni di servizio telefonico supplementari

Panoramica di riferimento su TAPI 2.2