Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) - Manual (Page 883)

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
Instantiate method.
Note
If the modem endpoint option list includes the modem profile
option (
kCMOModemProfile ), the modem setup is not invoked.
This allows modem applications to override the modem setup
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.
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.
◆