LINEDEVSTATE_
Constants
The
LINEDEVSTATE_ bit-flag constants describe various line status events.
LINEDEVSTATE_OTHER
Device-status
items other than those listed below have changed. The application should check
the current device status to determine which items have changed.
LINEDEVSTATE_RINGING
The switch
tells the line to alert the user. Service providers notify applications on each
ring cycle by sending LINE_LINEDEVSTATE messages containing this constant. For example, in
the United States, service providers send a message with this constant every
six seconds.
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 may happen, for example, if multiple line devices
share terminals among them (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
The locked
status of the line device has changed. (For more information, see
LINEDEVSTATUSFLAGS_LOCKED in the following topic, LINEDEVSTATUSFLAGS_ Constants.)
LINEDEVSTATE_CAPSCHANGE
Indicates
that, due to configuration changes made by the user or other circumstances, one
or more of the fields in the LINEDEVCAPS structure for the address have changed. The
application should use lineGetDevCaps to read the updated structure. If a service
provider sends a LINE_LINEDEVSTATE message containing this value to TAPI, TAPI will pass it
along to applications that have negotiated TAPI version 0x00010004 or above;
applications negotiating a previous API version will receive LINE_LINEDEVSTATE
messages specifying LINEDEVSTATE_REINIT, requiring them to shutdown and
reinitialize their connection to TAPI to obtain the updated information.
LINEDEVSTATE_CONFIGCHANGE
Indicates
that configuration changes have been made to one or more of the media devices
associated with the line device. The application, if it desires, may use lineGetDevConfig to read the updated
information. If a service provider sends a LINE_LINEDEVSTATE message containing
this value to TAPI, TAPI will pass it along to applications that have
negotiated TAPI version 0x00010004 or above; applications negotiating a previous
API version will not receive any notification.
LINEDEVSTATE_TRANSLATECHANGE
Indicates
that, due to configuration changes made by the user or other circumstances, one
or more of the fields in the LINETRANSLATECAPS5PWH.X structure have changed. The application
should use lineGetTranslateCaps to read the updated structure. If a service provider
sends a LINE_LINEDEVSTATE
message containing this value to TAPI, TAPI will pass it along to applications
that have negotiated TAPI version 0x00010004 or above; applications negotiating
a previous API version will receive LINE_LINEDEVSTATE messages specifying LINEDEVSTATE_REINIT,
requiring them to shutdown and reinitialize their connection to TAPI to obtain
the updated information.
LINEDEVSTATE_COMPLCANCEL
Indicates
that the call completion identified by the completion ID contained in the dwParam2
parameter of the LINE_LINEDEVSTATE message has been externally canceled and is
no longer considered valid (if that value were to be passed in a subsequent
call to lineUncompleteCall,
the function would fail with LINEERR_INVALCOMPLETIONID). If a service provider
sends a LINE_LINEDEVSTATE
message containing this value to TAPI, TAPI will pass it along to applications
which have negotiated TAPI version 0x00010004 or above; applications
negotiating a previous API version will not receive any notification.
LINEDEVSTATE_REMOVED
Indicates
that 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 that have negotiated TAPI
version 0x00010004 or above; applications negotiating a previous API version
will not receive any notification.
No
extensibility. All 32 bits are reserved.