Click or drag to resize
TapiCallConnectedMode Property
Gets the substate or mode of the connected call.

Namespace: Traysoft.AddTapi
Assembly: Traysoft.AddTapi (in Traysoft.AddTapi.dll) Version: 6.0.0.1110
Syntax
public TapiConnectedMode ConnectedMode { get; }

Property Value

Type: TapiConnectedMode
Remarks

The ConnectedMode property describes a mode of the connected call. This property becomes available to the application after the call state transitions to Connected. This property is used when the call is on an address that is shared (bridged) with other stations.

The Active and Inactive values are used when the call is on an address that is shared with other stations (bridged configuration). If the connected mode is "active," it means that the call is connected at the current station (the current station is a participant in the call). If the connected mode is Unknown (zero), the application should assume that the value is "active" (which would be the situation on a non-bridged address). If the connected mode is "inactive," the call is active at one or more other stations, but the current station is not a participant in the call. The mode can switch between Active and Inactive during a call if the user joins and leaves the call through manual action.

In such a bridged situation, a Disconnect or Hold operation may possibly not actually disconnect the call or place it on hold, because the status of other stations on the call may govern (for example, attempting to "hold" a call when other stations are participating will not be possible); instead, the call can simply be changed to the Inactive mode if it remains connected at other stations. A call in the Inactive state can be joined using the Answer.

Many operations that are valid in calls in the connected state can be impossible in the Inactive mode, such as monitoring for digits or audio playback/recording, because the station is not actually participating in the call; monitoring is usually suspended (although not canceled) while the call is in the Inactive mode.

See Also