2.5.2.3 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 via their ring mode number. A ring mode number ranges from zero to the number of available ring modes minus one.

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, a PHONE_STATUS message is sent to the TAPI DLL's callback to notify the TAPI DLL about the state change. Parameters to this message provide an indication of the change.