This property encapsulates the TAPI structure PHONECAPS which describes the capabilities of a phone device. The Caps property is set of sub-properties and each member holds a value of the capabilities of the phone device. The property is only valid if the device is selected successfully and theThbTapiPhone.Available property has value of True. See the Microsoft TAPI documentation of PHONECAPS for a complete description.

The most often used members of the phone device caps are:

Available
DeviceClasses
Features
ProviderInfo
PhoneInfo
PermanentPhoneID
PhoneName
StringFormat
PhoneStates
HookSwitchDevs
HandsetHookSwitchModes
SpeakerHookSwitchModes
HeadsetHookSwitchModes
VolumeFlags
GainFlags
DisplayNumRows
DisplayNumColumns
NumRingModes
NumButtonLamps

Availability

Design-Time: None / Run-Time: Read

Declaration

property Caps: ThbTapiPhoneCaps

See Also

PHONECAPS

Available (Boolean)

Indicates if the Caps property is available or not (see also ThbTapiPhone.DeviceID).

DeviceClasses (TStrings)

A list of device class identifiers supported by this device.

Features (DWORD)

These flags indicate which Telephony API functions can be invoked on the phone. A zero indicates the corresponding feature is not implemented and can never be invoked by the application on the phone; a one indicates the feature may be invoked depending on the device state and other factors. This member uses PHONEFEATURE_ Constants.

ProviderInfo (String)

The ProviderInfo member provides information about the provider hardware and/or software, such as the vendor name and version numbers of hardware and software.

PhoneInfo (String)

The PhoneInfo member provides information about the attached phone device, such as the phone device manufacturer, the model name, the software version, and so on. This information can be useful when a user needs to call customer service with problems regarding the phone.

PermanentPhoneID (DWORD)

The permanent DWORD identifier by which the phone device is known in the system's configuration.

PhoneName (String)

A user configurable name for the phone device. Same value as ThbTapiPhone.DeviceName.

StringFormat (DWORD)

The string format to be used with this phone device. This member uses one of the STRINGFORMAT_ Constants.

PhoneStates (DWORD)

The state changes for this phone device for which the application can be notified in a ThbTapiPhone.OnDeviceState event (PHONE_STATE message). This member uses one or more of the PHONESTATE_ Constants.

HookSwitchDevs (DWORD)

Specifies the phone's hookswitch devices. This member uses one of the PHONEHOOKSWITCHDEV_ Constants. The available hookswitch devices are also retieveable by the ThbTapiPhone.Handset/Headset/Speakerphone.Available properties.

HandsetHookSwitchModes
SpeakerHookSwitchModes
HeadsetHookSwitchModes (DWORD)

Specifies the phone's hookswitch mode capabilities of the handset, speaker, or headset, respectively. The member is only meaningful if the hookswitch device is listed in HookSwitchDevs. This member uses one of the PHONEHOOKSWITCHMODE_ Constants

VolumeFlags (DWORD)

Specifies the volume-setting capabilities of the phone device's speaker components. If the bit in position PHONEHOOKSWITCHDEV_ is TRUE, the volume of the corresponding hookswitch device's speaker component can be adjusted. Same as ThbTapiPhone.Handset/Headset/Speakerphone.VolumeAvailable.

GainFlags (DWORD)

Specifies the gain-setting capabilities of the phone device's microphone components. If the bit position PHONEHOOKSWITCHDEV_ is TRUE, the volume of the corresponding hookswitch device's microphone component can be adjusted. Same as ThbTapiPhone.Handset/Headset/Speakerphone.GainAvailable.

DisplayNumRows (DWORD)

Specifies the display capabilities of the phone device by describing the number of rows in the phone display. Same as ThbTapiPhone.Display.NumRows.

DisplayNumColumns (DWORD)

Specifies the display capabilities of the phone device by describing the number of columns in the phone display. Same as ThbTapiPhone.Display.NumColumns (See also Display).

NumRingModes (DWORD)

The ring capabilities of the phone device. The phone is able to ring with NumRingModes different ring patterns, identified as 1, 2, through NumRingModes minus one. If the value of this member is 0, applications have no control over the ring mode of the phone. If the value of this member is greater than 0, it indicates the number of ring modes in addition to silence that are supported by the service provider (See also Ringer).

NumButtonLamps (DWORD)

Specifies the number of button/lamps on the phone device that are detectable in TAPI. Button/lamps are identified by their identifier. Valid button/lamp identifiers range from zero to NumButtonLamps minus one. The keypad buttons '0', through '9', '*', and '#' are assigned the identifiers 0 through 12. Same as ThbTapiPhone.Controls.Count.