ThbTapiLine.Caps

This property encapsulates the TAPI LINEDEVCAPS structureis. It's a set of sub-properties and each member holds a value of the capabilities of the line device. The property is valid when the device is selected successfully and the Available property has value of True.

Availability

Design-Time: None / Run-Time: Read

Declaration

property Caps: ThbTapiLineCaps;

Description

Please refer to the section "LINEDEVCAPS" in TAPI's documentation for a more detailed information.

Flag array that indicates the different bearer modes that the address is able to support. This member uses one or more of the LINEBEARERMODE_ Constants. The LINEBEARERMODE_ bit-flag constants describe different bearer modes of a call. When an application makes a call, it can request a specific bearer mode. These modes are used to select a certain quality of service for the requested connection from the underlying telephone network. Bearer modes available on a given line are a device capability of the line.

Constant	Meaning
LINEBEARERMODE_VOICE	This is a regular 3.1 kHz analog voice-grade bearer service. Bit integrity is not assured. Voice can support fax and modem media types.
LINEBEARERMODE_SPEECH	This corresponds to G.711 speech transmission on the call. The network can use processing techniques such as analog transmission, echo cancellation, and compression/decompression. Bit integrity is not assured. Speech is not intended to support fax and modem media types.
LINEBEARERMODE_MULTIUSE	The multiuse mode defined by ISDN.
LINEBEARERMODE_DATA	The unrestricted data transfer on the call. The data rate is specified separately.
LINEBEARERMODE_ALTSPEECHDATA	The alternate transfer of speech or unrestricted data on the same call (ISDN).
LINEBEARERMODE_NONCALLSIGNALING	This corresponds to a non-call-associated signaling connection from the application to the service provider or switch (treated as a media stream by TAPI).
LINEBEARERMODE_PASSTHROUGH	When a call is active in LINEBEARERMODE_PASSTHROUGH, the service provider gives direct access to the attached hardware for control by the application. This mode is used primarily by applications desiring temporary direct control over asynchronous modems, accessed through the Win32 comm functions, for the purpose of configuring or using special features not otherwise supported by the service provider.
LINEBEARERMODE_RESTRICTEDDATA	Bearer service for digital data in which only the low-order seven bits of each octet may contain user data (for example, for Switched 56kbit/s service).

DevCapFlags (DWord)

Specifies various Boolean device capabilities. This member uses one or more of the LINEDEVCAPFLAGS_ Constants:

Constant	Meaning
LINEDEVCAPFLAGS_CALLHUB	Indicates whether call hubs are supported on this line. This flag is exposed only to applications that negotiate a TAPI version of 3.0 or higher and is not available in hbTapi.
LINEDEVCAPFLAGS_CALLHUBTRACKING	Indicates whether call hub tracking is supported on this line. This flag is exposed only to applications that negotiate a TAPI version of 3.0 or higher and is not available in hbTapi..
LINEDEVCAPFLAGS_CLOSEDROP	Specifies what happens when an open line is closed while the application has calls active on the line. If TRUE, the service provider drops (clears) all active calls on the line when the last application that has opened the line closes it with lineClose. If FALSE, the service provider does not drop active calls in such cases. Instead, the calls remain active and under control of external devices. A service provider typically sets this bit to FALSE if there is some other device that can keep the call alive, for example, if an analog line has the computer and phone set both connect directly to them in a party-line configuration, the offhook phone will automatically keep the call active even after the computer powers down. Applications should check this flag to determine whether to warn the user (with an OK/Cancel dialog box) that active calls will be lost.
LINEDEVCAPFLAGS_CROSSADDRCONF	Specifies whether calls on different addresses on this line can be conferenced.
LINEDEVCAPFLAGS_DIALBILLING LINEDEVCAPFLAGS_DIALDIALTONE LINEDEVCAPFLAGS_DIALQUIET	These flags indicate whether the "$", "@", or "W" dialable string modifier is supported for a given line device. It is TRUE if the modifier is supported; otherwise, FALSE. The "?" (prompt user to continue dialing) is never supported by a line device. These flags allow an application to determine up front which modifiers would result in the generation of a LINEERR. The application has the choice of pre-scanning dialable strings for unsupported characters or of passing the "raw" string from lineTranslateAddress directly to the provider as part of functions such as lineMakeCall or lineDial and let the function generate an error to tell it which unsupported modifier occurs first in the string.
LINEDEVCAPFLAGS_HIGHLEVCOMP	Specifies whether high-level compatibility information elements are supported on this line.
LINEDEVCAPFLAGS_LOWLEVCOMP	Specifies whether low-level compatibility information elements are supported on this line.
LINEDEVCAPFLAGS_MEDIACONTROL	Specifies whether media-control operations are available for calls at this line.
LINEDEVCAPFLAGS_MSP	Indicates whether a Media Service Provider (MSP) is associated with the line. This flag is exposed only to applications that negotiate a TAPI version of 3.0 or higher and is not available in hbTapi.
LINEDEVCAPFLAGS_MULTIPLEADDR	Specifies whether lineMakeCall, lineDial, TSPI_lineMakeCall, or TSPI_lineDial is able to deal with multiple addresses at once (as for inverse multiplexing).
LINEDEVCAPFLAGS_PRIVATEOBJECTS	Indicates whether provider-specific Interfaces have been implemented. This flag is exposed only to applications that negotiate a TAPI version of 3.0 or higher and is not available in hbTapi.

DeviceClasses (TStrings)

A list of device class identifiers supported on one or more addresses on this line.

GenerateToneModes (DWord)

The different kinds of tones that can be generated on this line. This member uses one or more of the LINETONEMODE_ Constants:

Constant	Meaning	Value (Hex)
LINETONEMODE_CUSTOM	The tone is a custom tone defined by its component frequencies, of type LINEGENERATETONE.	00000001
LINETONEMODE_RINGBACK	The tone is ringback tone. Exact definition is service-provider defined.	00000002
LINETONEMODE_BUSY	The tone is a busy tone. Exact definition is service-provider defined.	00000004
LINETONEMODE_BEEP	The tone is a beep, such as that used to announce the beginning of a recording. Exact definition is service-provider defined.	00000008
LINETONEMODE_BILLING	The tone is a billing information tone such as a credit card prompt tone. Exact definition is service-provider defined.	00000010

GenerateDigitModes (DWord)

Specifies the digit modes than can be generated on this line. This member uses one or more of the LINEDIGITMODE_ Constants:

Constant	Meaning
LINEDIGITMODE_PULSE	Use this mode to detect rotary pulse sequences to signal digits. Valid digits are 0 through 9.
LINEDIGITMODE_DTMF	Use this mode to detect DTMF tones. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'.
LINEDIGITMODE_DTMFEND	Use this mode to detect DTMF tones and detect the down edges. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'.

LineFeatures (DWord)

This member allows an application to discover which line features can be (and which can never be) supported by the device. A zero in a bit position indicates that the corresponding feature is never available. A one indicates that the corresponding feature may be available if the line is in the appropriate state for the operation to be meaningful.

This member uses one or mre of the LINEFEATURE_ Constants:

Constant	Meaning
LINEFEATURE_DEVSPECIFIC	Device-specific operations can be used on the line.
LINEFEATURE_DEVSPECIFICFEAT	Device-specific features can be used on the line.
LINEFEATURE_FORWARD	Forwarding of all addresses can be used on the line.
LINEFEATURE_FORWARDDND	The lineForward function (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. This flag is exposed only to applications that negotiate a TAPI version of 2.0 or higher.
LINEFEATURE_FORWARDFWD	The lineForward function can be used to forward calls on all address on the line to other numbers. LINEFEATURE_FORWARD will also be set. This flag is exposed only to applications that negotiate a TAPI version of 2.0 or higher.
LINEFEATURE_MAKECALL	An outgoing call can be placed on this line using an unspecified address.
LINEFEATURE_SETDEVSTATUS	The lineSetLineDevStatus function can be invoked on the line device. This flag is exposed only to applications that negotiate a TAPI version of 2.0 or higher.
LINEFEATURE_SETMEDIACONTROL	Media control can be set on this line.
LINEFEATURE_SETTERMINAL	Terminal modes for this line can be set.

LineName (String)

The name of the line device. The value is equal to the DeviceName property. This name can be configured by the user when configuring the line device's service provider, and is provided for the user's convenience.

LineStates (DWord)

Specifies the different line status components for which the application may be notified in an OnDeviceState event. This member uses one or more of the LINEDEVSTATE_ Constants.

MaxDialParams (DWord)

The maximum value, in milliseconds, for the dial parameters that can be set for calls on this line. Dialing parameters can be set to values in this range. The granularity of the actual settings is service provider-specific.

MaxNumActiveCalls (DWord)

Provides the maximum number of (minimum bandwidth) calls that can be active (connected) on the line at any one time. The actual number of active calls may be lower if higher bandwidth calls have been established on the line.

MediaModes (DWord)

Flag array that indicates the different media types the device is able to support. This member is used in context with ThbTapiLine's MediaMode property uses one or more of the LINEMEDIAMODE_ Constants:

Constant	Description
LINEMEDIAMODE_AUTOMATEDVOICE	Voice energy was detected on the call, and the voice is locally handled by an automated application such as with an answering machine application. When a service provider cannot distinguish between interactive and automated voice on an incoming call, it will report the call as interactive voice.
LINEMEDIAMODE_DATAMODEM	A data modem session on the call.
LINEMEDIAMODE_ADSI	An ADSI (Analog Display Services Interface) session on the call. ADSI enhances voice calls with alphanumeric information downloaded to the phone and the use of soft buttons on the phone.
LINEMEDIAMODE_DIGITALDATA	A digital data stream of unspecified format.
LINEMEDIAMODE_G3FAX	A group 3 fax is being sent or received over the call.
LINEMEDIAMODE_G4FAX	A group 4 fax is being sent or received over the call.
LINEMEDIAMODE_INTERACTIVEVOICE	Voice energy was detected on the call, and the call is handled as an interactive voice call with humans on both ends.
LINEMEDIAMODE_MIXED	A mixed session on the call. Mixed is one of the ISDN telematic services.
LINEMEDIAMODE_TDD	A TDD (Telephony Devices for the Deaf) session on the call.
LINEMEDIAMODE_TELETEX	A teletex session on the call. Teletex is one of the telematic services.
LINEMEDIAMODE_TELEX	A telex session on the call. Telex is one of the telematic services.
LINEMEDIAMODE_VIDEO	The media type of the call is video. (TAPI versions 2.1 and later)
LINEMEDIAMODE_VIDEOTEX	A videotex session on the call. Videotex is one the telematic services.
LINEMEDIAMODE_VOICEVIEW	The media type of the call is VoiceView. (TAPI versions 1.4 and later)
LINEMEDIAMODE_UNKNOWN	A media stream exists but its mode is not currently known and may become known later. This would correspond to a call with an unclassified media type. In typical analog telephony environments, an incoming call's media type may be unknown until after the call has been answered and the media stream has been filtered to make a determination. If the unknown media-mode flag is set, other media flags can also be set. This is used to signify that the media is unknown but that it is likely to be one of the other selected media types.

MinDialParams (DWord)

The minimum value, in milliseconds, for the dial parameters that can be set for calls on this line. Dialing parameters can be set to values in this range. The granularity of the actual settings is service provider-specific.

MonitorDigitModes (DWord)

Specifies the digit modes than can be detected on this line. This member is used in context wihThbTapiLine's CallOptions.MonitorDigits property and uses one or more of the LINEDIGITMODE_ Constants:

Constant	Meaning
LINEDIGITMODE_PULSE	Use this mode to detect rotary pulse sequences to signal digits. Valid digits are 0 through 9.
LINEDIGITMODE_DTMF	Use this mode to detect DTMF tones. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'.
LINEDIGITMODE_DTMFEND	Use this mode to detect DTMF tones and detect the down edges. Valid digits are 0 through 9, '*', '#', 'A', 'B', 'C', and 'D'.

NumAddresses (DWord)

The number of addresses associated with this line device. This value is equal to the Addresses.Count value.

PermanentLineID (DWord)

The permanent DWORD identifier by which the line device is known in the system's configuration. It is a permanent name for the line device. This permanent name (as opposed to DeviceID) does not change as lines are added or removed from the system, and persists through operating system upgrades. It can therefore be used to link line-specific information in .ini files (or other files) in a way that is not affected by adding or removing other lines or by changing the operating system.

ProviderInfo (String)

Information about the provider hardware and/or software, such as the vendor name and version numbers of hardware and software.

SwitchInfo (String)

This member provides information about the switch to which the line device is connected.