Other Call Appearance Feature Flags (IM: Telephony)

Chapter 4 - Call Appearances / Call Appearance Reference

Other Call Appearance Feature Flags
The call appearance structure contains, in the otherFeatures field, a set of bit flags indicating the relationship between certain additional features and that particular call. A given feature can be subscribed, available, or active.
To specify the features of a given call appearance, the Telephone Manager defines the TELCAFeatureFlags (page 4-15) and the TELCAOtherFeatures data types. The TELCAOtherFeatures data type is defined as follows:
typedef unsigned long      TELCAOtherFeatures;
All unused bits in the featureFlags field are reserved.
enum {
   callbackSub             = 1L << 0,
   callbackAvail           = 1L << 1,
   callbackActive          = 1L << 2,
   callbackClearSub        = 1L << 3,
   callbackNowSub          = 1L << 4,
   callbackNowAvail        = 1L << 5,
   callbackBusy            = 1L << 6,
   callbackNoAnswer        = 1L << 7,
   callbackReturnsRef      = 1L << 8,
   parkSub                 = 1L << 9,
   parkAvail               = 1L << 10,
   parkActive              = 1L << 11,
   parkRetrieveSub         = 1L << 12,
   parkRetrieveWithID      = 1L << 13,
   parkWithReturnedID      = 1L << 14,
   parkWithGivenID         = 1L << 18,
   rejectable              = 1L << 15,
   deflectable             = 1L << 16,
   acceptable              = 1L << 17,
   voiceDetected           = 1L << 19,
   callAnswdTSRings        = 1L << 20,
   progressHasDuration     = 1L << 21
};
Constant descriptions

callbackSub
If this bit is set, the Callback feature is subscribed.
callbackAvail
If this bit is set, the Callback feature is available.
callbackActive
If this bit is set, the Callback feature is active.
callbackClearSub
If this bit is set, the Callback Clear feature is subscribed.
callbackNowSub
If this bit is set, the Callback Now feature is subscribed.
callbackNowAvail
If this bit is set, the Callback Now feature is available.
callbackBusy
If this bit is set, you can request a callback notification if the destination number is busy.
callbackNoAnswer
If this bit is set, when the remote party does not answer, you can request that the remote party call you back.
callbackReturnsRef
If this bit is set, the Callback feature uses a reference number to identify a callback request. If set, then the TELCallbackSet function (page 4-42) provides the reference number, and you need to pass it to TELCallbackNow (page 4-43) and TELCallbackClear (page 4-44).
parkSub
If this bit is set, the Call Park feature is subscribed.
parkAvail
If this bit is set, the Call Park feature is available.
parkActive
If this bit is set, the Call Park feature is active.
parkRetrieveSub
If this bit is set, the Call Park Retrieve feature is subscribed.
parkRetrieveWithID
If this bit is set, the Call Park Retrieve feature requires an ID assigned by the telephone system. The TELParkCall function (page 4-45) returns the ID; you pass it to the TELRetrieveParkedCall function (page 4-46) to retrieve the call.
parkWithReturnedID
Reserved.
parkWithGivenID
If this bit is set, the Call Park Retrieve feature requires an ID generated by the user. You pass the ID to the TELParkCall function (page 4-45) to park the call, and to the TELRetrieveParkedCall function (page 4-46) to retrieve the call.
rejectable
If this bit is set, this incoming call can be rejected. (Use the TELRejectCall function (page 4-31) to reject the call.)
deflectable
If this bit is set, this incoming call can be deflected. (Use the TELDeflectCall function (page 4-32) to deflect the call.)
acceptable
If this bit is set, this incoming call can be accepted. (Use the TELAcceptCall function (page 4-29) to accept the call.)
voiceDetected
If this bit is set, for an incoming call, a voice signal was detected. This bit gets set if you call the TELCAVoiceDetect function (page 4-50) and a voice signal is detected. Once set, it is never cleared.
callAnswdTSRings
If this bit is set, this incoming call was auto-answered with the Call Saver feature enabled. (The Call Saver feature is the ability to auto-answer a call on a greater or lesser number of rings, depending on certain conditions, such as the existence of voice mail messages. The call saver ring count is a tool-specific number; the mechanism to set the call saver ring count is also tool specific. For example, some tools may use a control panel to elicit a number from the user.)
progressHasDuration
If this bit is set, call progress messages for this call appearance contain a duration value, expressed in milliseconds, in the mType parameter to the call appearance message handler.