PHONEBUTTONFUNCTION_ Constants

The PHONEBUTTONFUNCTION_ scalar constants describe the functions commonly assigned to buttons on telephone sets.

PHONEBUTTONFUNCTION_UNKNOWN

A "dummy" function assignment that indicates that the exact function of the button is unknown or has not been assigned.

PHONEBUTTONFUNCTION_CONFERENCE

Initiate a conference call or add a call to a conference call.

PHONEBUTTONFUNCTION_TRANSFER

Initiate a call transfer or complete the transfer of a call.

PHONEBUTTONFUNCTION_DROP

Drop the active call.

PHONEBUTTONFUNCTION_HOLD

Place the active call on hold.

PHONEBUTTONFUNCTION_RECALL

Unhold a call.

PHONEBUTTONFUNCTION_DISCONNECT

Disconnect a call, such as after initiating a transfer.

PHONEBUTTONFUNCTION_CONNECT

Reconnect a call that is on consultation hold.

PHONEBUTTONFUNCTION_MSGWAITON

Turn on a message waiting lamp.

PHONEBUTTONFUNCTION_MSGWAITOFF

Turn off a message waiting lamp.

PHONEBUTTONFUNCTION_SELECTRING

Allow the user to select the ring pattern of the phone.

PHONEBUTTONFUNCTION_ABBREVDIAL

The number to be dialed is indicated using a short, abbreviated number consisting of one or a few digits.

PHONEBUTTONFUNCTION_FORWARD

Initiate or change call forwarding to this phone.

PHONEBUTTONFUNCTION_PICKUP

Pick up a call ringing on another phone.

PHONEBUTTONFUNCTION_RINGAGAIN

Initiate a request to be notified if a call cannot be completed normally because of a busy or no answer.

PHONEBUTTONFUNCTION_PARK

Park the active call on another phone, placing it on hold there.

PHONEBUTTONFUNCTION_REJECT

Reject an inbound call before the call has been answered.

PHONEBUTTONFUNCTION_REDIRECT

Redirect an inbound call to another extension before the call has been answered.

PHONEBUTTONFUNCTION_MUTE

Mute the phone's microphone device.

PHONEBUTTONFUNCTION_VOLUMEUP

Increase the volume of audio through the phone's handset speaker or speakerphone.

PHONEBUTTONFUNCTION_VOLUMEDOWN

Decrease the volume of audio through the phone's handset speaker or speakerphone.

PHONEBUTTONFUNCTION_SPEAKERON

Turn the phone's external speaker on.

PHONEBUTTONFUNCTION_SPEAKEROFF

Turn the phone's external speaker off.

PHONEBUTTONFUNCTION_FLASH

Generate the equivalent of an onhook/offhook sequence. A flash typically indicates that any digits typed next are to be understood as commands to the switch. On many switches, places an active call on consultation hold.

PHONEBUTTONFUNCTION_DATAON

Indicate that the next call is a data call.

PHONEBUTTONFUNCTION_DATAOFF

Indicate that the next call is not a data call.

PHONEBUTTONFUNCTION_DONOTDISTURB

Place the phone in "do not disturb" mode; incoming calls receive a busy signal or are forwarded to an operator or voice mail system.

PHONEBUTTONFUNCTION_INTERCOM

Connect to the intercom to broadcast a page.

PHONEBUTTONFUNCTION_BRIDGEDAPP

Select a particular appearance of a bridged address.

PHONEBUTTONFUNCTION_BUSY

Make the phone appear "busy" to incoming calls.

PHONEBUTTONFUNCTION_CALLAPP

Select a particular call appearance.

PHONEBUTTONFUNCTION_DATETIME

Cause the phone to display current date and time; this information is sent by the switch.

PHONEBUTTONFUNCTION_DIRECTORY

Call up directory service from the switch.

PHONEBUTTONFUNCTION_COVER

Forward all calls destined for this phone to another phone used for coverage.

PHONEBUTTONFUNCTION_CALLID

Request display of caller ID on the phone's display.

PHONEBUTTONFUNCTION_LASTNUM

Redial last number dialed.

PHONEBUTTONFUNCTION_NIGHTSRV

Place the phone in the mode it is configured for during night hours.

PHONEBUTTONFUNCTION_SENDCALLS

Send all calls to another phone used for coverage; same as PHONEBUTTONFUNCTION_COVER.

PHONEBUTTONFUNCTION_MSGINDICATOR

Control the message indicator lamp.

PHONEBUTTONFUNCTION_REPDIAL

Repertory dialing;the number to be dialed is provided as a shorthand following pressing of this button.

PHONEBUTTONFUNCTION_SETREPDIAL

Programs the shorthand-to-phone number mappings accessible by means of repertory dialing (the "REPDIAL" button).

PHONEBUTTONFUNCTION_SYSTEMSPEED

The number to be dialed is provided as a shorthand following pressing of this button. The mappings for system speed dialing are configured inside the switch.

PHONEBUTTONFUNCTION_STATIONSPEED

The number to be dialed is provided as a shorthand following pressing of this button. The mappings for station speed dialing are specific to this station (phone).

PHONEBUTTONFUNCTION_CAMPON

Camp on an extension that returns a busy indication. When the remote station returns to idle, the phone rings with a distinctive pattern. Picking up the local phone reinitiates the call.

PHONEBUTTONFUNCTION_SAVEREPEAT

When pressed while a call or call attempt is active, it will remember that call's number or command. When pressed while no call is active (such as during dial tone), it repeats the most saved command.

PHONEBUTTONFUNCTION_QUEUECALL

Queue a call to an outside number after it encounters a trunk-busy indiction. When a trunk later becomes available, the phone rings with a distinctive pattern. Picking up the local phone reinitiates the call.

PHONEBUTTONFUNCTION_NONE

A "dummy" function assignment that indicates the button does not have a function.

Values in the range 0x80000000 to 0xFFFFFFFF can be assigned for device-specific extensions; values in the range 0x00000000 to 0x7FFFFFFF are reserved.

The PHONEBUTTONFUNCTION_ constants have values commonly found on current telephone sets. These button functions can be used to invoke the corresponding function from the switch using TSPI_lineDevSpecificFeature. Note that TAPI does not define the semantics of the button functions, it only provides access to the corresponding function. The behavior associated with each of the function values described earlier is generic and can vary based on the telephony environment.

See Also

PHONE_BUTTON, TSPI_lineDevSpecificFeature, TSPI_phoneGetButtonInfo, TSPI_phoneSetButtonInfo