Configuration Information

Configuration information related to the telephony API is stored in the TELEPHON.INI file. The only application visible section in TELEPHON.INI is the [HandoffPriorities] section.

Users may manipulate the entries in [HandoffPriorities] directly, or, more preferably, through the Preferences settings of Telephony-aware applications. Such applications should be capable of adding entries to [HandoffPriorities] for media modes they support, and of rearranging the application names in entries in the section (to set themselves as the highest priority, for example). Entries in the [HandoffPriorities] section are not manipulated through the Telephony control panel.

This section shall be in the following format:

[HandoffPriorities]

RequestMakeCall=[<appname>[,<appname>]...]

RequestMediaCall=[<appname>[,<appname>]...]

RequestLogEntry=[<appname>[,<appname>]...]

unknown=[<appname>[,<appname>]...]

interactivevoice=[<appname>[,<appname>]...]

automatedvoice=[<appname>[,<appname>]...]

g3fax=[<appname>[,<appname>]...]

g4fax=[<appname>[,<appname>]...]

datamodem=[<appname>[,<appname>]...]

teletex=[<appname>[,<appname>]...]

videotex=[<appname>[,<appname>]...]

telex=[<appname>[,<appname>]...]

mixed=[<appname>[,<appname>]...]

tdd=[<appname>[,<appname>]...]

adsi=[<appname>[,<appname>]...]

digitaldata=[<appname>[,<appname>]...]

NumExtends=<count>

extendx=<uuid>,<bit>,"<friendlyname>",[<appname>[,<appname>]...]

where each <appname> is the module filename of a Windows Telephony application.

NumExtends provides a count of the number of extendx lines which follow (with x taking values from 0 through <count>-1).. By default, it is set to 0. It may be adjusted by any application which adds or deletes an extended media mode.

Each extendx line gives the Universally Unique Identifier for the extension set, a bit identifier corresponding to the LINEMEDIAMODE bit assigned in that extension set, a friendly name for the media mode (assigned by the provider or application, based on a priori knowledge), and the application priorities.

<uuid> shall be expressed in the standard text UUID format as output by the UUIDGEN program: 8 hex digits, a hyphen, 4 hex digits, a hyphen, 4 hex digits, a hyphen, 4 hex digits, a hyphen, and 12 hex digits (e.g., A2A9E740-A0A5-1068-968A-08002B312E8A). It need not be surrounded by quotation marks.

<bit> shall be a single decimal digit with a value from 1 to 8. These identifiers correspond to the following bit values in LINEMEDIAMODE (which are the only values available for assignment to proprietary media modes in provider extensions):