Funzione phoneGetRing (tapi.h)
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 |