LINEDEVSTATE_ Constants
The LINEDEVSTATE_ bit-flag constants describe various line status events.
-
LINEDEVSTATE_OTHER
-
Device-status items other than those listed below have changed.
-
LINEDEVSTATE_RINGING
-
The switch tells the line to alert the user. This should be sent repeatedly in a LINE_LINEDEVSTATE message, once for each ring cycle. On a POTS device, the service provider can send the message whenever the central office sends ring voltage. On digital devices such as ISDN, the service provider may need to synthesize the repetition of the message if the switch generates only one ring request. Each repetition of the message should show the ring count increasing, so that toll save functions work properly.
-
LINEDEVSTATE_CONNECTED
-
The line was previously disconnected and is now connected to TAPI.
-
LINEDEVSTATE_DISCONNECTED
-
This line was previously connected and is now disconnected from TAPI.
-
LINEDEVSTATE_MSGWAITON
-
The "message" waiting indicator is turned on.
-
LINEDEVSTATE_MSGWAITOFF
-
The "message waiting" indicator is turned off.
-
LINEDEVSTATE_INSERVICE
-
The line is connected to TAPI. This happens when TAPI is first activated, or when the line wire is physically plugged in and in-service at the switch while TAPI is active.
-
LINEDEVSTATE_OUTOFSERVICE
-
The line is out of service at the switch or physically disconnected. TAPI cannot be used to operate on the line device.
-
LINEDEVSTATE_MAINTENANCE
-
Maintenance is being performed on the line at the switch. TAPI cannot be used to operate on the line device.
-
LINEDEVSTATE_OPEN
-
The line has been opened by another application.
-
LINEDEVSTATE_CLOSE
-
The line has been closed by another application.
-
LINEDEVSTATE_NUMCALLS
-
The number of calls on the line device has changed.
-
LINEDEVSTATE_NUMCOMPLETIONS
-
The number of outstanding call completions on the line device has changed.
-
LINEDEVSTATE_TERMINALS
-
The terminal settings have changed. This can happen, for example, if multiple line devices share terminals (for example, two lines sharing a phone terminal).
-
LINEDEVSTATE_ROAMMODE
-
The roam mode of the line device has changed.
-
LINEDEVSTATE_BATTERY
-
The battery level has changed significantly (cellular).
-
LINEDEVSTATE_SIGNAL
-
The signal level has changed significantly (cellular).
-
LINEDEVSTATE_DEVSPECIFIC
-
The line's device-specific information has changed.
-
LINEDEVSTATE_REINIT
-
Items have changed in the configuration of line devices. To become aware of these changes (as for the appearance of new line devices) the application should reinitialize its use of TAPI.
-
LINEDEVSTATE_LOCK
-
This value is most often used with line devices associated with cellular phones. Many cellular phones have a security mechanism that requires the entry of a password to enable the phone to place calls. This value can be used to indicate to TAPI and its client applications that the phone is locked and cannot place calls until the password is entered on the user interface of the phone, so that the application can present an appropriate alert to the user.
-
LINEDEVSTATE_REMOVED
-
The device is being removed from the system by the service provider (most likely through user action, through a control panel or similar utility). A LINE_LINEDEVSTATE message with this value will normally be immediately followed by a LINE_CLOSE message on the device. Subsequent attempts to access the device prior to TAPI being reinitialized will result in LINEERR_NODEVICE being returned to the application. If a service provider sends a LINE_LINEDEVSTATE message containing this value to TAPI, TAPI will pass it along to applications which have negotiated this or a subsequent API version; applications negotiating a previous API version will not receive any notification.
Not extensible. All 32 bits are reserved.
See Also
LINE_ADDRESSSTATE, LINE_ CLOSE, LINE_LINEDEVSTATE, TSPI_lineForward, TSPI_lineGetLineDevStatus