Funzione phoneGetRing (tapi.h)

  • Articolo

La funzione phoneGetRing consente a un'applicazione di eseguire una query sul dispositivo telefono aperto specificato in base alla modalità di anello corrente.

Sintassi

LONG phoneGetRing(
  HPHONE  hPhone,
  LPDWORD lpdwRingMode,
  LPDWORD lpdwVolume
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto.

lpdwRingMode

Modello di squillamento con cui il telefono sta squillando. Zero indica che il telefono non sta squillando.

lpdwVolume

Livello di volume con cui il telefono sta squillando. 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_OPERATIONUNAVAIL PHONEERR_UNINITIALIZED.

Commenti

Il provider di servizi definisce i modelli di squillo udibili effettivi corrispondenti a ognuna delle modalità di anello del telefono.

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