2.2.3.1.19 LINECALLFEATURE_Constants

  • Article

The LINECALLFEATURE_Constants are bit-flag constants that indicate operations that can be invoked for a particular address or call.

Constant/value

Description

LINECALLFEATURE_ACCEPT

0x00000001

Accept the call (use the Accept packet).

LINECALLFEATURE_ADDTOCONF

0x00000002

Add the call to the current conference (use the AddToConference packet).

LINECALLFEATURE_ANSWER

0x00000004

Answer the call (use the Answer packet).

LINECALLFEATURE_BLINDTRANSFER

0x00000008

Perform a blind transfer on the call (use the BlindTransfer packet).

LINECALLFEATURE_COMPLETECALL

0x00000010

Complete the call (use the CompleteCall packet).

LINECALLFEATURE_COMPLETETRANSF

0x00000020

Complete the call transfer (use the CompleteTransfer packet).

LINECALLFEATURE_DIAL

0x00000040

Dial the destination number for the call (use the Dial packet).

LINECALLFEATURE_DROP

0x00000080

Drop the call (use the Drop packet).

LINECALLFEATURE_GATHERDIGITS

0x00000100

Gather digits from the call (use the GatherDigits packet).

LINECALLFEATURE_GENERATEDIGITS

0x00000200

Generate digits on the call (use the GenerateDigits packet).

LINECALLFEATURE_GENERATETONE

0x00000400

Generate tones on the call (use the GenerateTone packet).

LINECALLFEATURE_HOLD

0x00000800

Put the call on hold (use the Hold packet).

LINECALLFEATURE_MONITORDIGITS

0x00001000

Monitor digits on the call (use the MonitorDigits packet).

LINECALLFEATURE_MONITORMEDIA

0x00002000

Monitor the media of the call (use the MonitorMedia packet).

LINECALLFEATURE_MONITORTONES

0x00004000

Monitor tones on the call (use the MonitorTones packet).

LINECALLFEATURE_PARK

0x00008000

Park the call (use the Park packet).

LINECALLFEATURE_PREPAREADDCONF

0x00010000

Prepare the call for addition to a conference (use the PrepareAddToConference packet).

LINECALLFEATURE_REDIRECT

0x00020000

Redirect the call to another destination (use the Redirect packet).

LINECALLFEATURE_REMOVEFROMCONF

0x00040000

Remove the call from the conference (use the RemoveFromConference packet).

LINECALLFEATURE_SECURECALL

0x00080000

Secure the call (use the SecureCall packet).

LINECALLFEATURE_SENDUSERUSER

0x00100000

Send user-user information (use the SendUserUserInfo packet).

LINECALLFEATURE_SETCALLPARAMS

0x00200000

Set call parameters (use the SetCallParams packet).

LINECALLFEATURE_SETMEDIACONTROL

0x00400000

Set media controls (see the SetMediaControl packet).

LINECALLFEATURE_SETTERMINAL

0x00800000

Set the terminal to be used with the call (use SetTerminal packet).

LINECALLFEATURE_SETUPCONF

0x01000000

Set up a conference (use the SetUpConference packet).

LINECALLFEATURE_SETUPTRANSFER

0x02000000

Set up a transfer (use the SetUpTransfer packet).

LINECALLFEATURE_SWAPHOLD

0x04000000

Perform a swap hold operation (use the SwapHold packet).

LINECALLFEATURE_UNHOLD

0x08000000

Take the call off hold (use the Unhold packet).

The following constants are present in TAPI versions 1.4, 2.0, 2.1, 2.2, 3.0, and 3.1:

Constant/value

Description

LINECALLFEATURE_RELEASEUSERUSERINFO

0x10000000

Release current user-user information (use the ReleaseUserUserInfo packet).

The following constants are present in TAPI versions 2.0, 2.1, 2.2, 3.0, and 3.1:

Constant/value

Description

LINECALLFEATURE_SETTREATMENT

0x20000000

Set call treatment (use the SetCallTreatment packet).

LINECALLFEATURE_SETQOS

0x40000000

Set Quality of Service (QoS) levels for the call (use the SetCallQualityOfService packet).

LINECALLFEATURE_SETCALLDATA

0x80000000

Set the call data packet (use the SetCallData packet).

These constants MUST be used both in LINEADDRESSCAPS (returned by the GetAddressCaps packet) and in LINECALLSTATUS (returned by the GetCallStatus packet). The LINEADDRESSCAPS packet reports the availability of the call features on the specified address. An application would use this information when it initializes to determine what it can do when calls exist. For the specified call, LINECALLSTATUS reports which call features can be invoked while the call is in the current call state. The latter takes call privileges into account. An application would make this determination dynamically after the call state changes.

The LINECALLFEATURE_RELEASEUSERUSERINFO value is new to TAPI 1.4. There are no backward compatibility considerations. A service provider can elect to return this value in relevant members (in LINEADDRESSCAPS and LINECALLSTATUS) even when older TAPI versions have been negotiated on the line device.