2.2.3.1.39 LINEFEATURE_Constants

The LINEFEATURE_Constants are bit-flag constants that list the operations that can be invoked on a line.

Constant/value

Description

LINEFEATURE_DEVSPECIFIC

0x00000001

Device-specific operations can be used on the line.

LINEFEATURE_DEVSPECIFICFEAT

0x00000002

Device-specific features can be used on the line.

LINEFEATURE_FORWARD

0x00000004

Forwarding of all addresses can be used on the line.

LINEFEATURE_MAKECALL

0x00000008

An outgoing call can be placed on this line using an unspecified address.

LINEFEATURE_SETMEDIACONTROL

0x00000010

Media control can be set on this line.

LINEFEATURE_SETTERMINAL

0x00000020

Terminal modes for this line can be set.

Note If neither of the new modified "FORWARD" bits is set in the dwLineFeatures member in LINEDEVSTATUS, but the LINEFEATURE_FORWARD bit is set, any of the forward modes can work; the service provider has simply not specified which ones.

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

Constant/value

Description

LINEFEATURE_SETDEVSTATUS

0x00000040

The SetLineDevStatus packet can be invoked on the line device.

LINEFEATURE_FORWARDFWD

0x00000080

The Forward packet can be used to forward calls on all addresses on the line to other numbers. LINEFEATURE_FORWARD will also be set.

LINEFEATURE_FORWARDDND

0x00000100

The Forward packet (with an empty destination address) can be used to turn on the Do Not Disturb feature on all addresses on the line. LINEFEATURE_FORWARD will also be set.

The LINEFEATURE_Constants are used in LINEDEVSTATUS (returned by the GetLineDevStatus packet). LINEDEVSTATUS reports, for a particular line, which line features can actually be invoked while the line is in the current state. An application would make this determination dynamically after line state changes, which are typically caused by address or call-related activities on the line.