INtimeÂ® 3.1 Software - tenAsys

More documents

Recommendations

Info

INtime <strong>3.1</strong> <strong>Software</strong> RT services and device drivers RT service calls System call DeliverMessage DeliverStatus DeliverTransaction DequeueInputTransaction DequeueOutputTransaction EnqueueInputTransaction EnqueueOutPutTransaction EnterServiceRegion ExitServiceRegion GetPortId GetPortParameter GetTransaction LookupPortHandle QueryInputTransactionQueue QueryOutputTransactionQueue ReleaseControlBuffer ReleaseTransaction Description Delivers a complete transactionless message to a port. This call is typically made from the service thread. Terminates a transmit operation, usually from the service thread. Delivers a transaction. This call is used after a service thread receives a response message, and the transaction is complete. Dequeues the transaction at the head of the service input queue and returns a pointer to it. Dequeues the transaction at the head of the service output queue and returns a pointer to it. Enqueues a transaction on the service input queue. This allows the service to maintain an ordered list of requests for later completion by the service thread. Enqueues a transaction on the service output queue when (for example) the transmitter hardware is busy. Enters the region associated with the service. Currently the SendMessage handler is called while in this region. If mutual exclusion is desired between the service thread and the SendMessage handler, the service thread can make this call. Exits the service region previously entered with EnterServiceRegion. Returns the port ID for a given port handle. Retrieves the parameter previously associated with a port by a call to SetPortParameter. Upon receiving a response message from the interface, instructs the service thread to tie the message with its transaction structure. Looks up a port handle given a port ID. Returns the transaction at the head of the service input queue. Returns the transaction at the head of the service output queue. Returns a control buffer to the service pool. Returns a transaction structure to the pool. 132
Appendix A: INtime software system calls System call RequestControlBuffer RequestTransaction SetPortParameter Description Requests a control buffer from the service pool. Requests a TRANSACTION buffer from the service transaction pool. Sets the port parameter for the given port to a value given by the caller. RT service handlers Service handlers are subroutines invoked by the kernel to perform service-dependent functions of the system calls. For example, calling SendRtMessage causes the kernel to invoke the handler supplied by the service to handle the transmission of the message to the interface. Some of these handlers must be supplied by the service while others are optional. The control and transaction buffer pools are the static resources used for allocating internal data structures. The size of these pools is determined from parameters in the service descriptor at installation time. System call CancelTransaction CreatePort DeletePort Finish GetAttributes GetFragment Initialize SendMessage Service Description implement special actions as a result of calling CancelRtTransaction or DeleteRtPort. Invoked when CreateRtPort is called. A status of E_OK must be returned for the port to be created, else the port object is deleted and the status code is returned to the caller. Invoked when DeleteRtPort is called. It must return a status of E_OK for the port to be deleted, else the port object is deleted and the status code is returned to the caller. Ensures that any service-dependent resources are cleaned up before the service process is killed. Gets attributes from the service when an application calls GetRtServiceAttributes. Invoked when an application calls ReceiveRtFragment. Performs any service-specific initialization functions and returns a suitable status code to the caller. Implemented by all services which require a transmission function. Invoked by the service thread when an event occurs. 133
Page 1 and 2:
U S E R ’ S M A N U A L INtime ®
Page 3 and 4:
Before you begin This guide describ
Page 5 and 6:
Before you begin Glossary Notationa
Page 7 and 8:
Before you begin • Within source
Page 9 and 10:
Contents Part I Chapter 1 Chapter 2
Page 11 and 12:
Contents Part II Chapter 6 Chapter
Page 13 and 14:
Contents Part III Appendix A Append
Page 15 and 16:
Contents NTX DLLs..................
Page 17 and 18:
I Introducing INtime software This
Page 19 and 20:
1 Overview INtime software extends
Page 21 and 22:
Chapter 1: Overview Considerations
Page 23 and 24:
Chapter 1: Overview Developing an I
Page 25 and 26:
Chapter 1: Overview INtime software
Page 27 and 28:
Chapter 1: Overview • INtime Grap
Page 29 and 30:
Chapter 1: Overview • Remote conf
Page 31 and 32:
2 Understanding INtime software arc
Page 33 and 34:
Chapter 2: Understanding INtime sof
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
Page 43 and 44:
Page 45 and 46:
3 About INtime software’s RT kern
Page 47 and 48:
Chapter 3: About INtime software’
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
Page 55 and 56:
4 About RT programming This chapter
Page 57 and 58:
Chapter 4: About RT programming Pre
Page 59 and 60:
Chapter 4: About RT programming whe
Page 61 and 62:
Chapter 4: About RT programming Fig
Page 63 and 64:
Chapter 4: About RT programming Syn
Page 65 and 66:
Chapter 4: About RT programming The
Page 67 and 68:
Chapter 4: About RT programming Exc
Page 69 and 70:
Chapter 4: About RT programming Str
Page 71 and 72:
5 Designing RT applications This ch
Page 73 and 74:
Chapter 5: Designing RT application
Page 75 and 76:
Chapter 5: Designing RT application
Page 77 and 78:
II Using INtime software This part
Page 79 and 80:
6 Installation This chapter explain
Page 81 and 82:
Chapter 6: Installation 5. Select o
Page 83 and 84:
7 Configuration INtime software pro
Page 85 and 86:
Chapter 7: Configuration Tab Local
Page 87 and 88:
Chapter 7: Configuration Configurin
Page 89 and 90:
Chapter 7: Configuration Setting th
Page 91 and 92:
8 Preparing an RT node This chapter
Page 93 and 94:
Chapter 8: Preparing an RT node Bui
Page 95 and 96:
Chapter 8: Preparing an RT node 4.
Page 97 and 98: Chapter 8: Preparing an RT node Fir
Page 99 and 100: 9 Operation This chapter describes
Page 101 and 102: Chapter 9: Operation • INtime too
Page 103 and 104: 10 INtime application development T
Page 105 and 106: Chapter 10: INtime application deve
Page 125 and 126: III Appendices The appendices inclu
Page 127 and 128: A INtime software system calls This
Page 129 and 130: Appendix A: INtime software system
Page 147: Appendix A: INtime software system
Page 157 and 158: B The iwin32 subsystem This appendi
Page 159 and 160: Appendix B: The iwin32 subsystem A
Page 161 and 162: Appendix B: The iwin32 subsystem Mu
Page 163 and 164: Appendix B: The iwin32 subsystem Sh
Page 165 and 166: Appendix B: The iwin32 subsystem Us
Page 167 and 168: Appendix B: The iwin32 subsystem Pr
Page 169 and 170: C INtime directory structure This a
Page 171 and 172: D INtime software components This a
Page 173 and 174: Appendix D: INtime software compone
Page 189 and 190: E Visual Studio .NET debugging for
Page 191 and 192: Appendix E: Visual Studio .NET debu
Page 193 and 194: F Adding INtime software to an XP E
Page 195 and 196: G Troubleshooting This appendix lis
Page 197 and 198: Appendix G: Troubleshooting Table G
Page 199 and 200:
Appendix G: Troubleshooting Table G
Page 201 and 202:
Glossary application loader asynchr
Page 203 and 204:
Glossary memory area memory pool me
Page 205 and 206:
Index A B C D E F G H I J K L M N O
Page 207 and 208:
A B C D E F G H I J K L M N O P Q R
Page 209 and 210:
Page 211 and 212:
Page 213 and 214:
Page 215 and 216:
Page 217 and 218:
show all

INtimeÂ® 3.1 Software - tenAsys

Create successful ePaper yourself

Delete template?

Save as template?