Ring

A single phone may be able to ring with different ring modes. Given the wide variety of ring modes available, ring modes are identified by their ring mode number. A ring mode number ranges from zero to the number of available ring modes, with ring mode 0 indicating silence.

TSPI_phoneSetRing rings an open phone device according to a given ring mode. TSPI_phoneGetRing returns the current ring mode of an opened phone device.

When the ring mode of a phone device is changed, the service provider sends a PHONE_STATE message to the TAPI callback function to notify it about the state change. Parameters to this message provide an indication of the change.