Inside Macintosh: Telephony /

Chapter 2 - Telephone Terminals / Telephone Terminals Reference

Constants

Volume Controls

The volType parameter of the TELGetVolume and TELSetVolume functions and the mtype parameter of the telTermVolMsg and the telTermVolStateMsg messages return one of the following constants to indicate the type of device whose volume has been adjusted or whose volume state has changed:

enum {
   telHandsetSpeakerVol    = 1,
   telHandsetMicVol        = 2,
   telSpeakerphoneVol      = 3,
   telSpeakerphoneMicVol   = 4,
   telRingerVol            = 5,
   telBuiltinSPVol         = 6,
   telBuiltinSPMicVol      = 7
};

Constant descriptions

telHandsetSpeakerVol

The volume of the handset speaker.

telHandsetMicVol

The sensitivity of the handset microphone.

telSpeakerphoneVol

The volume of the speaker phone.

telSpeakerphoneMicVol

The sensitivity of the speaker phone microphone.

telRingerVol

The volume of the ringer.

telBuiltinSPVol

The volume of the built-in speakerphone. A built-in speaker phone is a speakerphone that is built in to the computer. Typically, this consists of the computer's microphone and speaker together with software that functions as a speakerphone.

telBuiltinSPMicVol

The sensitivity of the built-in speakerphone microphone.

Note

Device type values in the range 8 through 255 are reserved for use by the Telephone Manager. Device type values in the range 256 through 32768 are available for use by telephone tools.

The level parameter of the TELGetVolume and TELSetVolume functions and the value parameter of the telTermVolMsg message return one of the following constants, or a value between telVolMin and telVolMax, to indicate the level to which the volume has been adjusted:

enum {
   telVolSame              = 0,
   telVolMin               = 1,
   telVolMax               = 100
};

Constant descriptions

telVolSame

The volume remains at its previous level.

telVolMin

The minimum volume level.

telVolMax

The maximum volume level.

The volState parameter of the TELGetVolume and TELSetVolume functions and the value parameter of the telTermVolStateMsg message returns one of the following constants to indicate the new state of the device:

enum {
   telVolStateSame         = 0,
   telVolStateOff          = 1,
   telVolStateOn           = 2
};

Constant descriptions

telVolStateSame

The volume state remains in its previous state.

telVolStateOff

The volume state is off. The device is muted but the volume level is unchanged.

telVolStateOn

The volume state is on. The volume level is set to its previous level.

Note

Volume state values in the range 3 through 255 are reserved for use by the Telephone Manager. Volume state values in the range 256 through 32768 are available for use by telephone tools.