2.2.3.1.45 LINEOFFERINGMODE_Constants
The LINEOFFERINGMODE_Constants are bit-flag constants that describe different substates of an offering call. A mode is available as call status after the call state transitions to offering, and within the LINE_CALLSTATE packet, indicating that the call is in LINECALLSTATE_OFFERING, as specified in section 2.2.3.1.29. These values are used when the call is on an address that is shared (bridged) with other stations, primarily electronic key systems.
The following constants are present in TAPI versions 1.4, 2.0, 2.1, 2.2, 3.0, and 3.1.
|
Constant/value |
Description |
|---|---|
|
LINEOFFERINGMODE_ACTIVE 0x00000001 |
Indicates that the call is alerting at the current station (will be accompanied by LINEDEVSTATE_RINGING packets), and if any application is set to automatically answer, it can do so. If the call state mode is zero, the application assumes that the value is active (which would be the situation on a non-bridged address). |
|
LINEOFFERINGMODE_INACTIVE 0x00000002 |
Indicates that the call is being offered at more than one station; however, the current station is not alerting (for example, it can be an attendant station where the offering status is advisory, such as blinking a light). It is preferable that software at the station that is set for automatic answering not answer the call because answering is to be the prerogative of the primary (alerting) station; however, the Answer packet can be used to connect the call. |
For backward compatibility, it is the responsibility of the service provider to examine the negotiated TAPI version on the line and not to use these LINEOFFERINGMODE_Constants values if they are not supported on the negotiated version.
The LINEOFFERINGMODE_ACTIVE and LINEOFFERINGMODE_INACTIVE values are used when the call is on an address that is shared with other stations, primarily electronic key systems. (For more information about bridged addressing, see LINEADDRESSSHARING_Constants.) If the offering call state mode is "active", the call is alerting at the current station (it will be accompanied by LINEDEVSTATE_RINGING packets), and if any application is set up to automatically answer, it can do so. If the call state mode is "inactive", the call is being offered at more than one station; however, the current station is not alerting (for example, it can be an attendant station where the offering status is advisory, such as blinking a light).
Software at the station that is set for automatic answering SHOULD preferably not answer the call because this SHOULD be the prerogative of the primary (alerting) station; however, the Answer packet can be used to connect the call. If the call state mode is 0, the application SHOULD assume that the value is active (which would be the situation on a non-bridged address).