Platform SDK: TAPI

Device Events

A device event notification indicates that the status of a device has changed, such as a phone has started ringing or a modem has been removed. A TAPI application should respond to a device event by querying for the specific change that has occurred and then taking appropriate action.

A TAPI 2 application receives notification of device events using the LINE_LINEDEVSTATE message. The current status of an address is determined by calling lineGetAddressStatus, which returns its information in a LINEADDRESSSTATUS structure. The status of a specified open line device is obtained by calling lineGetLineDevStatus, which returns its information in a LINEDEVSTATUS structure.

A TAPI 3 application receives an ADDRESS_EVENT notification, which is processed using the ITAddressEvent interface. The ITAddressCapabilities can then be used to acquire more detail information.