C H A P T E R 2 5
Modem Setup Service
About the Modem Setup Service
25-3
Figure 25-1
Modem preferences view
The Modem Setup Process
25
All communication applications that use a modem endpoint make use of the
modem setup service. The current modem setup is automatically invoked when
an application calls the modem endpoint's
modem setup service. The current modem setup is automatically invoked when
an application calls the modem endpoint's
Instantiate
method.
Note
If the modem endpoint option list includes the modem profile
option (
option (
kCMOModemProfile
), the modem setup is not invoked.
This allows modem applications to override the modem setup
when configuring the modem for special purposes.
when configuring the modem for special purposes.
Here is what happens in the
Instantiate
method when the modem setup
is invoked:
1. The
kCMOModemPrefs
option is added to the endpoint configuration options,
and the
fEnablePassThru
field is set to
true
. This enables the endpoint to
operate in pass-through mode. In this mode, the modem endpoint is functionally
equivalent to a serial endpoint for input and output.
equivalent to a serial endpoint for input and output.
2. The modem endpoint is instantiated and connected in pass-through mode.
3. The Newton system software sets the modem preferences (
kCMOModemPrefs
),
modem profile (
kCMOModemProfile
), and fax profile
(
kCMOModemFaxCapabilities
) options as defined in the modem setup.
Note
A modem setup method is executed only once--when the
endpoint is instantiated--even if the endpoint is subsequently
used for multiple connections.
endpoint is instantiated--even if the endpoint is subsequently
used for multiple connections.