funzione phoneGetVolume (tapi.h)

La funzione phoneGetVolume restituisce l'impostazione del volume del dispositivo hookswitch del telefono specificato.

Sintassi

LONG phoneGetVolume(
  HPHONE  hPhone,
  DWORD   dwHookSwitchDev,
  LPDWORD lpdwVolume
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto.

dwHookSwitchDev

Un singolo dispositivo hookswitch il cui livello di volume viene sottoposto a query. Questo parametro usa una delle costanti PHONEHOOKSWITCHDEV_.

lpdwVolume

Puntatore a un DWORD. La funzione restituisce l'impostazione del volume corrente del dispositivo hookswitch in questa posizione. Numero compreso 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.

Valore restituito

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

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, 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 supplementari del servizio telefonico

Panoramica dei riferimenti a TAPI 2.2