funzione phoneGetGain (tapi.h)

  • Articolo

La funzione phoneGetGain restituisce l'impostazione del guadagno del microfono del dispositivo hookswitch specificato.

Sintassi

LONG phoneGetGain(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwGain
);

Parametri

hPhone

Gestire il dispositivo telefono aperto.

dwHookSwitchDev

Dispositivo Hookswitch il cui livello di guadagno viene sottoposto a query. Il parametro dwHookSwitchDev può avere un solo set di bit. Questo parametro usa uno e solo uno dei costanti PHONEHOOKSWITCHDEV_.

lpdwGain

Puntatore a una DWORD contenente l'impostazione di guadagno corrente del componente microfono hookswitch. Il parametro dwGain specifica il livello di volume del dispositivo hookswitch. Questo è un numero 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.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, 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

Vedi anche

Funzioni di servizio telefonico supplementari

Panoramica di riferimento su TAPI 2.2