2.5.2.5 Lamps

The lamps on a phone device can be lit in a variety of different lighting modes. Unlike ringing patterns, lamp modes are more uniform across phone sets of different vendors. A common set of lamp modes is defined by the SPI. A lamp identified by its lamp/button ID can be lit in a given lamp mode. A lamp can also be queried for its current lamp mode.

TSPI_phoneSetLamp

Lights a lamp on a specified open phone device in a given lamp lighting mode

TSPI_phoneGetLamp

Returns the current lamp mode of the specified lamp.

When a lamp 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.