(Page 1 of 15 in this chapter) Version

Chapter 6

Alphabetical Function Reference

This chapter provides a comprehensive, alphabetically-ordered reference to the BRI service functions. A prototype of each function is shown with the function description, details of all arguments, and return values. Some of the fields in the function definition include: Prototype The prototype is followed by a listing of the function's arguments. Natural MicroSystems types include the following: · WORD · DWORD · INT16 · INT32 · BYTE 16-bit unsigned 32-bit unsigned 16-bit signed 32-bit signed 8-bit unsigned If a function argument is a data structure, the complete data structure is defined. Refer to Appendix D for a description of all parameters. Return Values The return value for a function is either SUCCESS or an error code. For asynchronous functions, a return value of SUCCESS indicates the function was initiated; subsequent events indicate the status of the operation. Refer to Appendix B for a listing of all errors returned by the BRI service functions. Events If events are listed, the function is asynchronous and is complete when the DONE event is returned. If there are no events listed, the function is synchronous. Additional information such as reason codes and return values may be provided in the value field of the event. Refer to Appendix C for details for all BRI service events. Example Examples are given to help you use the BRI service API. The notation /* ... */ indicates additional code which is not shown.

Prototype	The prototype is followed by a listing of the function's arguments. Natural MicroSystems types include the following:
	· `WORD` · `DWORD` · `INT16` · `INT32` · `BYTE`	16-bit unsigned 32-bit unsigned 16-bit signed 32-bit signed 8-bit unsigned
	If a function argument is a data structure, the complete data structure is defined. Refer to Appendix D for a description of all parameters.
Return Values	The return value for a function is either `SUCCESS` or an error code. For asynchronous functions, a return value of `SUCCESS` indicates the function was initiated; subsequent events indicate the status of the operation. Refer to Appendix B for a listing of all errors returned by the BRI service functions.
Events	If events are listed, the function is asynchronous and is complete when the `DONE` event is returned. If there are no events listed, the function is synchronous. Additional information such as reason codes and return values may be provided in the `value` field of the event. Refer to Appendix C for details for all BRI service events.
Example	Examples are given to help you use the BRI service API. The notation `/* ... */` indicates additional code which is not shown.

(Page 1 of 15 in this chapter) Version