GEOS SDK TechDocs
|
| 
| 
1 Design Philosophy
One of the most important functions of a portable computing device is to exchange information with other devices. A portable computer might use a number of different physical means to transmit and receive information; it might also use a variety of communication protocols (some of which may not be invented yet!).
GEOS helps to insulate an application from the physical details of transmitting and receiving information. It does this with its Mailbox library, and associated drivers. The library lets each application transmit and receive information in more or less the same way, no matter how it uses the information, and no matter what it does with the information once it receives it (or how it assembles the information before transmitting it).
The Mailbox API relies heavily on a basic understanding of VMChain structures and routines. Please consult the Virtual Memory chapter of the Concepts book for more information.
NOTE: This is a preliminary document. Please consult the Mailbox definition files ( mailbox.def or mailbox.goh ) for current and complete information.
1 Design Philosophy
1.1 Mailbox Overview
1.2 Transport Driver Overview
2 Inbox/Outbox Structure
3 Mailbox Structures & Utilities
4 Data Formats
4.1 GMDFID_STREAM_GSTRING
4.2 GMDFID_VM_GSTRING
4.3 GMDFID_TRANSFER_ITEM
4.4 GMDFID_TEXT_CHAIN
4.5 GMDFID_TEXT_FILE
4.6 GMDFID_DOCUMENT
4.7 GMDFID_INK
4.8 GMDFID_VM_COMPOSITE
5 Data Drivers
6 Application Responsibilities
6.1 Providing a User-Interface
6.2 Sending a Message
6.3 Receiving and Processing Messages
7 Examples of Mailbox Usage
7.1 An Incoming Pager Email Message
7.2 Sending and Receiving an Address Book Page
GEOS SDK TechDocs
|
|
| 1 Design Philosophy