ModemList

Description: This function returns a list of the modems in the system. This function should be used to determine the correct parameter for the ModemStream or ModemDial functions.

Returns: Array

Usage: Script

Format: ModemList()

Parameters: None

Comments: The return value is a two-dimensional array with each row storing the information for a single modem (i.e. ArraySize(ReturnValue, 0) = = ModemCount( ) ). There are four columns per row as follows:

Column #	Information
0	The operating system enumeration for this device
1	Comport identifier (e.g. "COM1")
2	'Friendly name" of the modem (e.g. "Standard Modem")
3	MediaMode. Bit significant value indicating the capabilities of the modem. Please refer to ModemMedia for a description of valid values and their meanings.

The Microsoft Telephony Interface (TAPI) enumerates a number of devices – not just modems. This function enumerates only the data/voice modems into a compact list. The ordering of this list should not be relied upon as it may change due to system hardware changes.

To use this function:

1. Call the ModemList function

2. Iterate through the resulting array, choosing a modem by its 'Friendly Name' or by its 'MediaMode' capabilities.

3. Add one to the array index and use the resulting value as the first parameter to ModemStream or ModemDial.