Funzione phoneSetRing (tapi.h)

Articolo
03/02/2024

La funzione phoneSetRing suona il dispositivo telefono aperto specificato usando la modalità e il volume specificati.

Sintassi

LONG phoneSetRing(
  HPHONE hPhone,
  DWORD  dwRingMode,
  DWORD  dwVolume
);

Parametri

hPhone

Gestire il dispositivo telefonico aperto. L'applicazione deve essere il proprietario del dispositivo telefonico.

dwRingMode

Modello di squillo con cui squillare il telefono. Questo parametro deve essere compreso nell'intervallo di zero al valore del membro dwNumRingModes nella struttura PHONECAPS . Se dwNumRingModes è zero, la modalità anello del telefono non può essere controllata; se dwNumRingModes è 1, il valore 0 per dwRingMode indica che il telefono non deve essere generato (silenzio) e altri valori compresi tra 1 e dwNumRingModes sono modalità di anello valide per il dispositivo telefonico.

dwVolume

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. Un valore per dwVolume non compreso nell'intervallo viene impostato sul valore più vicino nell'intervallo.

Valore restituito

Restituisce un identificatore di richiesta positivo se la funzione viene completata in modo asincrono o 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_INVALRINGMODE, PHONEERR_UNINITIALIZED PHONEERR_OPERATIONUNAVAIL.