/ Aminet 18 / aminetcdnumber181997.iso / Aminet / misc / emu / AROSdev.lha / AROS / docs / src / devinfo-1.src

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 63 68 61 70 74 65 72 | 7b 49 6e 66 6f 72 6d 61 |\chapter|{Informa|
|00000010| 74 69 6f 6e 73 20 66 6f | 72 20 44 65 76 65 6c 6f |tions fo|r Develo|
|00000020| 70 65 72 73 7d 0a 0a 5c | 73 65 63 74 69 6f 6e 7b |pers}..\|section{|
|00000030| 44 69 66 66 65 72 65 6e | 63 65 73 20 62 65 74 77 |Differen|ces betw|
|00000040| 65 65 6e 20 41 6d 69 67 | 61 4f 53 20 61 6e 64 20 |een Amig|aOS and |
|00000050| 41 52 4f 53 7d 0a 0a 5c | 73 75 62 73 65 63 74 69 |AROS}..\|subsecti|
|00000060| 6f 6e 7b 50 6f 69 6e 74 | 65 72 2f 49 6e 74 65 67 |on{Point|er/Integ|
|00000070| 65 72 20 63 6f 6e 76 65 | 72 73 69 6f 6e 73 7d 0a |er conve|rsions}.|
|00000080| 0a 49 66 20 79 6f 75 20 | 6e 65 65 64 20 61 20 76 |.If you |need a v|
|00000090| 61 72 69 61 62 6c 65 20 | 77 68 69 63 68 20 63 61 |ariable |which ca|
|000000a0| 6e 20 73 74 6f 72 65 20 | 61 20 70 6f 69 6e 74 65 |n store |a pointe|
|000000b0| 72 73 20 61 73 20 61 6e | 20 69 6e 74 65 67 65 72 |rs as an| integer|
|000000c0| 2c 20 64 6f 6e 27 74 20 | 75 73 65 0a 7c 55 4c 4f |, don't |use.|ULO|
|000000d0| 4e 47 7c 20 62 75 74 20 | 7c 49 50 54 52 7c 2e 20 |NG| but ||IPTR|. |
|000000e0| 41 52 4f 53 20 67 75 61 | 72 61 6e 74 65 65 73 20 |AROS gua|rantees |
|000000f0| 74 68 61 74 20 7c 4c 4f | 4e 47 7c 20 69 73 20 33 |that |LO|NG| is 3|
|00000100| 32 62 69 74 20 6f 6e 20 | 61 6c 6c 20 73 79 73 74 |2bit on |all syst|
|00000110| 65 6d 73 2c 20 77 68 69 | 6c 65 0a 7c 49 50 54 52 |ems, whi|le.|IPTR|
|00000120| 7c 20 69 73 20 61 6c 77 | 61 79 73 20 6c 61 72 67 || is alw|ays larg|
|00000130| 65 20 65 6e 6f 75 67 68 | 20 74 6f 20 63 6f 6e 74 |e enough| to cont|
|00000140| 61 69 6e 20 61 20 70 6f | 69 6e 74 65 72 2e 20 4d |ain a po|inter. M|
|00000150| 6f 73 74 20 6e 6f 74 61 | 62 6c 65 20 74 68 69 6e |ost nota|ble thin|
|00000160| 67 73 0a 77 68 69 63 68 | 20 61 72 65 20 61 66 66 |gs.which| are aff|
|00000170| 65 63 74 65 64 20 62 79 | 20 74 68 69 73 3a 20 7c |ected by| this: ||
|00000180| 54 61 67 49 74 65 6d 7c | 73 20 28 74 68 65 20 7c |TagItem||s (the ||
|00000190| 74 69 5f 44 61 74 61 7c | 20 66 69 65 6c 64 20 69 |ti_Data|| field i|
|000001a0| 73 20 6e 6f 77 20 61 6e | 20 7c 49 50 54 52 7c 0a |s now an| |IPTR|.|
|000001b0| 69 6e 73 74 65 61 64 20 | 6f 66 20 7c 55 4c 4f 4e |instead |of |ULON|
|000001c0| 47 7c 29 2c 20 42 4f 4f | 50 53 49 20 63 6c 61 73 |G|), BOO|PSI clas|
|000001d0| 73 65 73 20 28 65 67 2e | 20 74 68 65 20 72 65 74 |ses (eg.| the ret|
|000001e0| 75 72 6e 20 76 61 6c 75 | 65 20 6f 66 20 7c 44 6f |urn valu|e of |Do|
|000001f0| 4d 65 74 68 6f 64 28 29 | 7c 29 2c 0a 7c 52 65 61 |Method()||),.|Rea|
|00000200| 64 41 72 67 73 28 29 7c | 2c 20 7c 56 50 72 69 6e |dArgs()||, |VPrin|
|00000210| 74 66 28 29 7c 2c 20 7c | 56 46 50 72 69 6e 74 66 |tf()|, ||VFPrintf|
|00000220| 28 29 7c 20 61 6e 64 20 | 6d 6f 72 65 2e 0a 0a 5c |()| and |more...\|
|00000230| 73 75 62 73 65 63 74 69 | 6f 6e 7b 36 34 62 69 74 |subsecti|on{64bit|
|00000240| 20 76 61 72 69 61 62 6c | 65 73 7d 0a 0a 54 68 65 | variabl|es}..The|
|00000250| 20 74 79 70 65 20 6f 66 | 20 36 34 62 69 74 20 76 | type of| 64bit v|
|00000260| 61 72 69 61 62 6c 65 73 | 20 69 73 20 7c 51 55 41 |ariables| is |QUA|
|00000270| 44 7c 20 28 75 6e 73 69 | 67 6e 65 64 3a 20 7c 55 |D| (unsi|gned: |U|
|00000280| 51 55 41 44 7c 29 2e 20 | 54 68 69 73 20 69 73 20 |QUAD|). |This is |
|00000290| 66 6f 72 20 65 78 61 6d | 70 6c 65 0a 72 65 74 75 |for exam|ple.retu|
|000002a0| 72 6e 65 64 20 62 79 20 | 74 68 65 20 66 75 6e 63 |rned by |the func|
|000002b0| 74 69 6f 6e 20 7c 53 4d | 75 6c 74 36 34 28 29 7c |tion |SM|ult64()||
|000002c0| 20 6f 66 20 75 74 69 6c | 69 74 79 2e 6c 69 62 72 | of util|ity.libr|
|000002d0| 61 72 79 2e 20 54 6f 20 | 61 63 63 65 73 73 20 74 |ary. To |access t|
|000002e0| 68 65 0a 68 69 67 68 2d | 20 61 6e 64 20 6c 6f 77 |he.high-| and low|
|000002f0| 6f 72 64 65 72 20 33 32 | 62 69 74 20 76 61 6c 75 |order 32|bit valu|
|00000300| 65 73 20 6f 66 20 74 68 | 65 20 36 34 62 69 74 20 |es of th|e 64bit |
|00000310| 76 61 72 69 61 62 6c 65 | 2c 20 75 73 65 20 7c 4c |variable|, use |L|
|00000320| 4f 57 33 32 4f 46 36 34 | 28 29 7c 0a 61 6e 64 20 |OW32OF64|()|.and |
|00000330| 7c 48 49 47 48 33 32 4f | 46 36 34 28 29 7c 20 77 ||HIGH32O|F64()| w|
|00000340| 68 69 63 68 20 61 72 65 | 20 64 65 66 69 6e 65 64 |hich are| defined|
|00000350| 20 69 6e 20 5c 66 69 6c | 65 6e 61 6d 65 7b 41 52 | in \fil|ename{AR|
|00000360| 4f 53 2f 69 6e 63 6c 75 | 64 65 2f 61 72 6f 73 2f |OS/inclu|de/aros/|
|00000370| 36 34 62 69 74 2e 68 7d | 2e 0a 0a 5c 73 75 62 73 |64bit.h}|...\subs|
|00000380| 65 63 74 69 6f 6e 7b 43 | 6c 6f 6e 69 6e 67 20 52 |ection{C|loning R|
|00000390| 61 73 74 50 6f 72 74 73 | 7d 0a 0a 41 52 4f 53 20 |astPorts|}..AROS |
|000003a0| 75 73 65 73 20 61 6e 20 | 65 78 74 65 72 6e 61 6c |uses an |external|
|000003b0| 20 64 72 69 76 65 72 20 | 74 6f 20 61 63 63 65 73 | driver |to acces|
|000003c0| 73 20 74 68 65 20 67 72 | 61 70 68 69 63 73 20 68 |s the gr|aphics h|
|000003d0| 61 72 64 77 61 72 65 2e | 20 53 69 6e 63 65 20 74 |ardware.| Since t|
|000003e0| 68 65 0a 6e 61 74 75 72 | 65 20 6f 66 20 74 68 69 |he.natur|e of thi|
|000003f0| 73 20 64 72 69 76 65 72 | 20 69 73 20 75 6e 6b 6e |s driver| is unkn|
|00000400| 6f 77 6e 20 74 6f 20 41 | 52 4f 53 2c 20 69 74 20 |own to A|ROS, it |
|00000410| 69 73 20 6e 6f 20 6c 6f | 6e 67 65 72 20 76 61 6c |is no lo|nger val|
|00000420| 69 64 20 74 6f 20 63 6c | 6f 6e 65 0a 61 20 52 61 |id to cl|one.a Ra|
|00000430| 73 74 50 6f 72 74 20 62 | 79 20 73 69 6d 70 6c 79 |stPort b|y simply|
|00000440| 20 63 6f 70 79 69 6e 67 | 20 69 74 2e 20 54 6f 20 | copying| it. To |
|00000450| 62 65 20 63 6f 6d 70 61 | 74 69 62 6c 65 2c 20 74 |be compa|tible, t|
|00000460| 68 65 72 65 20 61 72 65 | 20 74 77 6f 20 6e 65 77 |here are| two new|
|00000470| 0a 66 75 6e 63 74 69 6f | 6e 73 20 28 69 6e 20 41 |.functio|ns (in A|
|00000480| 52 4f 53 29 20 6f 72 20 | 6d 61 63 72 6f 73 20 28 |ROS) or |macros (|
|00000490| 6f 6e 20 41 6d 69 67 61 | 29 3a 20 7c 43 72 65 61 |on Amiga|): |Crea|
|000004a0| 74 65 52 61 73 74 50 6f | 72 74 28 29 7c 2c 0a 7c |teRastPo|rt()|,.||
|000004b0| 43 6c 6f 6e 65 52 61 73 | 74 50 6f 72 74 28 29 7c |CloneRas|tPort()||
|000004c0| 20 61 6e 64 20 7c 46 72 | 65 65 52 61 73 74 50 6f | and |Fr|eeRastPo|
|000004d0| 72 74 28 29 7c 2e 20 59 | 6f 75 20 6d 75 73 74 20 |rt()|. Y|ou must |
|000004e0| 63 61 6c 6c 20 7c 43 6c | 6f 6e 65 52 61 73 74 50 |call |Cl|oneRastP|
|000004f0| 6f 72 74 28 29 7c 20 74 | 6f 0a 63 72 65 61 74 65 |ort()| t|o.create|
|00000500| 20 61 20 63 6f 70 79 20 | 6f 72 20 7c 43 72 65 61 | a copy |or |Crea|
|00000510| 74 65 52 61 73 74 50 6f | 72 74 28 29 7c 20 66 6f |teRastPo|rt()| fo|
|00000520| 72 20 61 6e 20 65 6d 70 | 74 79 20 52 61 73 74 50 |r an emp|ty RastP|
|00000530| 6f 72 74 20 61 6e 64 0a | 7c 46 72 65 65 52 61 73 |ort and.||FreeRas|
|00000540| 74 50 6f 72 74 28 29 7c | 20 61 66 74 65 72 20 79 |tPort()|| after y|
|00000550| 6f 75 b4 76 65 20 64 6f | 6e 65 20 79 6f 75 72 20 |ou.ve do|ne your |
|00000560| 77 6f 72 6b 20 77 69 74 | 68 20 69 74 2e 0a 0a 54 |work wit|h it...T|
|00000570| 68 69 73 20 61 70 70 72 | 6f 61 63 68 20 70 72 6f |his appr|oach pro|
|00000580| 64 75 63 65 73 20 65 71 | 75 69 76 61 6c 65 6e 74 |duces eq|uivalent|
|00000590| 20 63 6f 64 65 20 6f 6e | 20 74 68 65 20 41 6d 69 | code on| the Ami|
|000005a0| 67 61 20 62 75 74 20 6f | 6e 20 41 52 4f 53 20 69 |ga but o|n AROS i|
|000005b0| 74 20 63 61 6e 20 73 6c | 6f 77 0a 74 68 69 6e 67 |t can sl|ow.thing|
|000005c0| 73 20 64 6f 77 6e 20 61 | 20 62 69 74 2e 20 49 66 |s down a| bit. If|
|000005d0| 20 79 6f 75 20 6d 75 73 | 74 20 70 72 65 73 65 72 | you mus|t preser|
|000005e0| 76 65 20 74 68 65 20 6f | 72 69 67 69 6e 61 6c 20 |ve the o|riginal |
|000005f0| 73 74 61 74 65 20 6f 66 | 20 74 68 65 20 52 61 73 |state of| the Ras|
|00000600| 74 50 6f 72 74 2c 0a 69 | 74 27 73 20 6d 6f 72 65 |tPort,.i|t's more|
|00000610| 20 73 61 66 65 20 74 6f | 20 63 72 65 61 74 65 20 | safe to| create |
|00000620| 61 20 63 6c 6f 6e 65 2c | 20 77 6f 72 6b 20 6f 6e |a clone,| work on|
|00000630| 20 69 74 20 61 6e 64 20 | 74 68 65 6e 20 64 69 73 | it and |then dis|
|00000640| 70 6f 73 65 20 6f 66 20 | 69 74 20 61 67 61 69 6e |pose of |it again|
|00000650| 2e 20 49 74 0a 63 61 6e | 20 61 6c 73 6f 20 62 65 |. It.can| also be|
|00000660| 20 66 61 73 74 65 72 20 | 69 66 20 79 6f 75 20 77 | faster |if you w|
|00000670| 6f 75 6c 64 20 68 61 76 | 65 20 74 6f 20 6d 61 6b |ould hav|e to mak|
|00000680| 65 20 61 20 6c 6f 74 20 | 6f 66 20 63 68 61 6e 67 |e a lot |of chang|
|00000690| 65 73 20 74 6f 20 74 68 | 65 20 52 61 73 74 50 6f |es to th|e RastPo|
|000006a0| 72 74 0a 74 6f 20 63 72 | 65 61 74 65 20 74 77 6f |rt.to cr|eate two|
|000006b0| 20 63 6c 6f 6e 65 73 20 | 61 6e 64 20 73 65 74 20 | clones |and set |
|000006c0| 74 68 65 6d 20 74 6f 20 | 74 68 65 20 74 77 6f 20 |them to |the two |
|000006d0| 73 74 61 74 65 73 20 79 | 6f 75 20 6e 65 65 64 2e |states y|ou need.|
|000006e0| 20 42 75 74 20 79 6f 75 | 72 20 63 6f 64 65 0a 73 | But you|r code.s|
|000006f0| 68 6f 75 6c 64 20 6e 6f | 74 20 64 65 70 65 6e 64 |hould no|t depend|
|00000700| 20 6f 6e 20 63 65 72 74 | 61 69 6e 20 67 61 69 6e | on cert|ain gain|
|00000710| 73 20 6f 72 20 6c 6f 73 | 73 65 73 20 6f 66 20 73 |s or los|ses of s|
|00000720| 70 65 65 64 20 64 75 65 | 20 74 6f 20 63 6c 6f 6e |peed due| to clon|
|00000730| 65 64 20 52 61 73 74 50 | 6f 72 74 73 0a 73 69 6e |ed RastP|orts.sin|
|00000740| 63 65 20 74 68 65 20 62 | 65 68 61 76 69 6f 75 72 |ce the b|ehaviour|
|00000750| 20 6f 66 20 74 68 65 20 | 75 6e 64 65 72 6c 79 69 | of the |underlyi|
|00000760| 6e 67 20 67 72 61 70 68 | 69 63 73 20 73 79 73 74 |ng graph|ics syst|
|00000770| 65 6d 20 69 73 20 75 6e | 64 65 66 69 6e 65 64 2e |em is un|defined.|
|00000780| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 7b 54 61 |..\subse|ction{Ta|
|00000790| 67 20 76 61 6c 75 65 73 | 7d 0a 0a 54 68 65 20 6f |g values|}..The o|
|000007a0| 72 69 67 69 6e 61 6c 20 | 41 6d 69 67 61 4f 53 20 |riginal |AmigaOS |
|000007b0| 64 6f 65 73 6e 27 74 20 | 75 73 65 20 74 68 65 20 |doesn't |use the |
|000007c0| 74 61 67 73 20 62 65 6c | 6f 77 20 7c 55 53 45 52 |tags bel|ow |USER|
|000007d0| 5f 54 41 47 7c 20 28 68 | 61 76 65 20 61 20 6c 6f |_TAG| (h|ave a lo|
|000007e0| 6f 6b 20 61 74 0a 5c 66 | 69 6c 65 6e 61 6d 65 7b |ok at.\f|ilename{|
|000007f0| 69 6e 63 6c 75 64 65 3a | 75 74 69 6c 69 74 79 2f |include:|utility/|
|00000800| 74 61 67 69 74 65 6d 2e | 68 7d 20 69 66 20 79 6f |tagitem.|h} if yo|
|00000810| 75 20 64 6f 6e 27 74 20 | 62 65 6c 69 76 65 20 6d |u don't |belive m|
|00000820| 65 29 20 77 68 69 63 68 | 20 6d 65 61 6e 73 2c 20 |e) which| means, |
|00000830| 79 6f 75 20 73 68 6f 75 | 6c 64 6e 27 74 20 75 73 |you shou|ldn't us|
|00000840| 65 0a 74 61 67 73 20 61 | 74 20 6f 72 20 6e 65 61 |e.tags a|t or nea|
|00000850| 72 20 7c 55 53 45 52 5f | 54 41 47 7c 20 62 65 63 |r |USER_|TAG| bec|
|00000860| 61 75 73 65 20 74 68 65 | 6e 20 74 68 65 79 20 6d |ause the|n they m|
|00000870| 69 67 68 74 20 69 6e 74 | 65 72 66 65 72 65 20 77 |ight int|erfere w|
|00000880| 69 74 68 20 74 68 65 20 | 4f 53 27 73 0a 6f 77 6e |ith the |OS's.own|
|00000890| 20 74 61 67 73 2e 20 54 | 6f 20 73 6f 6c 76 65 20 | tags. T|o solve |
|000008a0| 74 68 69 73 2c 20 41 52 | 4f 53 20 2a 64 6f 65 73 |this, AR|OS *does|
|000008b0| 2a 20 75 73 65 20 74 68 | 65 20 74 61 67 73 20 2a |* use th|e tags *|
|000008c0| 62 65 6c 6f 77 2a 20 7c | 55 53 45 52 5f 54 41 47 |below* ||USER_TAG|
|000008d0| 7c 20 61 6e 64 20 74 68 | 65 0a 76 61 72 69 6f 75 || and th|e.variou|
|000008e0| 73 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 6f 72 73 |s implem|entators|
|000008f0| 20 6e 65 65 64 20 6e 6f | 74 20 66 65 61 72 20 74 | need no|t fear t|
|00000900| 68 61 74 20 74 68 65 69 | 72 20 74 61 67 73 20 6d |hat thei|r tags m|
|00000910| 61 79 20 6f 76 65 72 6c | 61 70 20 77 69 74 68 20 |ay overl|ap with |
|00000920| 74 68 65 0a 6f 6e 65 73 | 20 66 72 6f 6d 20 74 68 |the.ones| from th|
|00000930| 65 20 73 79 73 74 65 6d | 2e 20 54 68 65 20 66 69 |e system|. The fi|
|00000940| 6c 65 20 5c 66 69 6c 65 | 6e 61 6d 65 7b 41 52 4f |le \file|name{ARO|
|00000950| 53 2f 69 6e 63 6c 75 64 | 65 2f 75 74 69 6c 69 74 |S/includ|e/utilit|
|00000960| 79 2f 74 61 67 69 74 65 | 6d 2e 68 7d 20 6e 6f 77 |y/tagite|m.h} now|
|00000970| 20 63 6f 6e 74 61 69 6e | 73 20 74 68 65 0a 62 61 | contain|s the.ba|
|00000980| 73 69 63 20 6f 66 66 73 | 65 74 73 20 66 6f 72 20 |sic offs|ets for |
|00000990| 74 68 65 20 76 61 72 69 | 6f 75 73 20 70 61 72 74 |the vari|ous part|
|000009a0| 73 20 6f 66 20 74 68 65 | 20 4f 53 2e 20 49 6e 20 |s of the| OS. In |
|000009b0| 74 68 65 20 66 75 74 75 | 72 65 2c 20 69 74 20 6d |the futu|re, it m|
|000009c0| 69 67 68 74 20 62 65 0a | 70 6f 73 73 69 62 6c 65 |ight be.|possible|
|000009d0| 20 66 6f 72 20 75 73 65 | 72 73 20 74 6f 20 61 6c | for use|rs to al|
|000009e0| 6c 6f 63 61 74 65 20 72 | 61 6e 67 65 73 20 6f 66 |locate r|anges of|
|000009f0| 20 74 61 67 73 20 66 6f | 72 20 73 70 65 63 69 66 | tags fo|r specif|
|00000a00| 69 63 20 75 73 65 73 2e | 0a 0a 5c 73 75 62 73 65 |ic uses.|..\subse|
|00000a10| 63 74 69 6f 6e 7b 44 6f | 4d 65 74 68 6f 64 28 29 |ction{Do|Method()|
|00000a20| 20 6f 72 20 74 68 65 20 | 73 74 61 63 6b 20 69 73 | or the |stack is|
|00000a30| 20 61 6c 6c 20 77 72 6f | 6e 67 7d 0a 0a 54 68 65 | all wro|ng}..The|
|00000a40| 72 65 20 61 72 65 20 43 | 50 55 73 20 61 72 6f 75 |re are C|PUs arou|
|00000a50| 6e 64 20 77 68 69 63 68 | 20 64 6f 6e 27 74 20 63 |nd which| don't c|
|00000a60| 61 72 65 20 74 68 61 74 | 20 74 68 65 20 72 65 73 |are that| the res|
|00000a70| 74 20 6f 66 20 74 68 65 | 20 77 6f 72 6c 64 20 68 |t of the| world h|
|00000a80| 61 76 65 0a 73 74 61 63 | 6b 73 20 77 68 69 63 68 |ave.stac|ks which|
|00000a90| 20 67 72 6f 77 20 66 72 | 6f 6d 20 6c 61 72 67 65 | grow fr|om large|
|00000aa0| 20 74 6f 20 73 6d 61 6c | 6c 20 61 64 72 65 73 73 | to smal|l adress|
|00000ab0| 65 73 2e 20 48 50 50 41 | 20 69 73 20 61 6e 20 65 |es. HPPA| is an e|
|00000ac0| 78 61 6d 70 6c 65 20 66 | 6f 72 0a 74 68 69 73 2e |xample f|or.this.|
|00000ad0| 20 57 68 69 6c 65 20 69 | 74 20 6d 69 67 68 74 20 | While i|t might |
|00000ae0| 6c 6f 6f 6b 20 6e 65 61 | 74 20 74 6f 20 74 68 65 |look nea|t to the|
|00000af0| 20 65 6e 67 69 6e 65 65 | 72 73 20 77 68 6f 20 64 | enginee|rs who d|
|00000b00| 69 64 20 69 74 2c 20 69 | 74 20 62 72 65 61 6b 73 |id it, i|t breaks|
|00000b10| 20 6f 75 72 0a 63 6f 64 | 65 2e 20 41 6e 6f 74 68 | our.cod|e. Anoth|
|00000b20| 65 72 20 74 68 69 6e 67 | 20 77 68 69 63 68 20 62 |er thing| which b|
|00000b30| 72 65 61 6b 73 20 74 68 | 65 20 63 6f 64 65 20 61 |reaks th|e code a|
|00000b40| 72 65 20 73 6d 61 6c 6c | 20 64 61 74 61 20 74 79 |re small| data ty|
|00000b50| 70 65 73 20 28 65 67 2e | 20 7c 57 4f 52 44 7c 2c |pes (eg.| |WORD|,|
|00000b60| 0a 7c 55 42 59 54 45 7c | 2c 20 65 74 63 29 2c 20 |.|UBYTE||, etc), |
|00000b70| 62 65 63 61 75 73 65 20 | 6d 6f 73 74 20 73 79 73 |because |most sys|
|00000b80| 74 65 6d 73 20 70 75 74 | 20 6f 6e 6c 79 20 69 6e |tems put| only in|
|00000b90| 74 65 67 65 72 73 20 6f | 72 20 6c 6f 6e 67 73 20 |tegers o|r longs |
|00000ba0| 61 6e 64 20 70 6f 69 6e | 74 65 72 73 0a 6f 6e 20 |and poin|ters.on |
|00000bb0| 74 68 65 20 73 74 61 63 | 6b 2e 20 53 6f 20 69 66 |the stac|k. So if|
|00000bc0| 20 73 6f 6d 65 20 4d 73 | 67 20 73 74 72 75 63 74 | some Ms|g struct|
|00000bd0| 75 72 65 20 65 78 70 65 | 63 74 73 20 7c 57 4f 52 |ure expe|cts |WOR|
|00000be0| 44 7c 20 28 73 65 65 0a | 5c 66 69 6c 65 6e 61 6d |D| (see.|\filenam|
|00000bf0| 65 7b 69 6e 63 6c 75 64 | 65 3a 69 6e 74 75 69 74 |e{includ|e:intuit|
|00000c00| 69 6f 6e 2f 67 61 64 67 | 65 74 63 6c 61 73 73 2e |ion/gadg|etclass.|
|00000c10| 68 7d 29 2c 20 74 68 69 | 73 20 66 61 69 6c 73 20 |h}), thi|s fails |
|00000c20| 6f 6e 20 65 76 65 72 79 | 20 73 79 73 74 65 6d 20 |on every| system |
|00000c30| 62 75 74 0a 74 68 65 20 | 41 6d 69 67 61 2e 20 54 |but.the |Amiga. T|
|00000c40| 68 65 6e 20 74 68 65 72 | 65 20 61 72 65 20 72 75 |hen ther|e are ru|
|00000c50| 6d 6f 75 72 73 20 61 62 | 6f 75 74 20 43 50 55 73 |mours ab|out CPUs|
|00000c60| 20 77 68 69 63 68 20 75 | 73 65 20 33 32 62 69 74 | which u|se 32bit|
|00000c70| 20 6e 75 6d 62 65 72 73 | 20 61 6e 64 0a 36 34 62 | numbers| and.64b|
|00000c80| 69 74 20 70 6f 69 6e 74 | 65 72 73 20 6f 72 20 74 |it point|ers or t|
|00000c90| 68 65 20 6f 74 68 65 72 | 20 77 61 79 20 72 6f 75 |he other| way rou|
|00000ca0| 6e 64 2e 20 4f 6e 20 74 | 68 65 73 65 20 43 50 55 |nd. On t|hese CPU|
|00000cb0| 73 2c 20 7c 53 65 74 41 | 74 74 72 73 28 29 7c 20 |s, |SetA|ttrs()| |
|00000cc0| 61 6e 64 20 61 6c 6c 0a | 6f 74 68 65 72 20 66 75 |and all.|other fu|
|00000cd0| 6e 63 74 69 6f 6e 20 77 | 68 69 63 68 20 70 61 73 |nction w|hich pas|
|00000ce0| 73 20 54 61 67 4c 69 73 | 74 73 20 6f 76 65 72 20 |s TagLis|ts over |
|00000cf0| 74 68 65 20 73 74 61 63 | 6b 20 77 69 6c 6c 20 66 |the stac|k will f|
|00000d00| 61 69 6c 2e 20 54 6f 20 | 6f 76 65 72 63 6f 6d 65 |ail. To |overcome|
|00000d10| 0a 74 68 69 73 2c 20 77 | 65 20 69 6e 74 72 6f 64 |.this, w|e introd|
|00000d20| 75 63 65 20 74 68 69 73 | 20 72 75 6c 65 3a 0a 0a |uce this| rule:..|
|00000d30| 5c 62 65 67 69 6e 7b 65 | 6d 70 68 7d 0a 49 66 20 |\begin{e|mph}.If |
|00000d40| 79 6f 75 20 77 61 6e 74 | 20 74 6f 20 70 61 73 73 |you want| to pass|
|00000d50| 20 61 20 73 74 72 75 63 | 74 75 72 65 20 77 69 74 | a struc|ture wit|
|00000d60| 68 20 7c 44 6f 4d 65 74 | 68 6f 64 28 29 7c 20 61 |h |DoMet|hod()| a|
|00000d70| 6e 64 20 7c 44 6f 4d 65 | 74 68 6f 64 41 28 29 7c |nd |DoMe|thodA()||
|00000d80| 0a 6f 72 20 73 69 6d 69 | 6c 61 72 20 66 75 6e 63 |.or simi|lar func|
|00000d90| 74 69 6f 6e 73 2c 20 79 | 6f 75 20 6d 75 73 74 20 |tions, y|ou must |
|00000da0| 70 72 65 70 65 6e 64 20 | 7c 53 54 41 43 4b 7c 20 |prepend ||STACK| |
|00000db0| 74 6f 20 65 61 63 68 20 | 74 79 70 65 2c 20 6c 69 |to each |type, li|
|00000dc0| 6b 65 0a 74 68 69 73 3a | 20 7c 57 4f 52 44 7c 20 |ke.this:| |WORD| |
|00000dd0| 62 65 63 6f 6d 65 73 20 | 7c 53 54 41 43 4b 57 4f |becomes ||STACKWO|
|00000de0| 52 44 7c 2c 20 7c 55 4c | 4f 4e 47 7c 20 62 65 63 |RD|, |UL|ONG| bec|
|00000df0| 6f 6d 65 73 20 7c 53 54 | 41 43 4b 55 4c 4f 4e 47 |omes |ST|ACKULONG|
|00000e00| 7c 2c 20 65 74 63 2e 0a | 5c 65 6e 64 7b 65 6d 70 ||, etc..|\end{emp|
|00000e10| 68 7d 0a 0a 54 6f 20 73 | 6f 6c 76 65 20 73 70 65 |h}..To s|olve spe|
|00000e20| 63 69 61 6c 20 70 72 6f | 62 6c 65 6d 73 20 6f 6e |cial pro|blems on|
|00000e30| 20 63 65 72 74 61 69 6e | 20 43 50 55 73 2c 20 77 | certain| CPUs, w|
|00000e40| 65 20 74 72 79 20 74 6f | 20 67 65 74 20 61 20 63 |e try to| get a c|
|00000e50| 6f 6d 70 69 6c 65 72 20 | 77 68 69 63 68 0a 67 65 |ompiler |which.ge|
|00000e60| 74 73 20 69 74 20 72 69 | 67 68 74 20 6f 72 2c 20 |ts it ri|ght or, |
|00000e70| 69 66 20 74 68 61 74 20 | 69 73 20 69 6d 70 6f 73 |if that |is impos|
|00000e80| 73 69 62 6c 65 2c 20 77 | 65 20 77 72 69 74 65 20 |sible, w|e write |
|00000e90| 61 20 73 6d 61 6c 6c 20 | 70 72 65 70 72 6f 63 65 |a small |preproce|
|00000ea0| 73 73 6f 72 0a 77 68 69 | 63 68 20 72 65 70 6c 61 |ssor.whi|ch repla|
|00000eb0| 63 65 73 20 74 68 65 20 | 64 75 62 69 6f 75 73 20 |ces the |dubious |
|00000ec0| 63 6f 64 65 20 62 79 20 | 63 61 6c 6c 73 20 74 6f |code by |calls to|
|00000ed0| 20 74 68 65 20 61 72 72 | 61 79 20 76 65 72 73 69 | the arr|ay versi|
|00000ee0| 6f 6e 73 2e 0a 0a 5c 73 | 75 62 73 65 63 74 69 6f |ons...\s|ubsectio|
|00000ef0| 6e 7b 52 65 67 69 73 74 | 65 72 73 20 61 6e 64 20 |n{Regist|ers and |
|00000f00| 43 50 55 73 7d 0a 0a 41 | 52 4f 53 20 68 61 73 20 |CPUs}..A|ROS has |
|00000f10| 70 75 74 20 73 6f 6d 65 | 20 65 66 66 6f 72 74 20 |put some| effort |
|00000f20| 69 6e 20 64 65 66 69 6e | 69 6e 67 20 61 20 77 61 |in defin|ing a wa|
|00000f30| 79 20 74 6f 20 77 72 69 | 74 65 20 63 6f 64 65 20 |y to wri|te code |
|00000f40| 77 68 69 63 68 20 69 73 | 20 68 61 72 64 77 61 72 |which is| hardwar|
|00000f50| 65 0a 69 6e 64 65 70 65 | 6e 64 61 6e 74 2e 20 54 |e.indepe|ndant. T|
|00000f60| 6f 20 61 63 68 69 65 76 | 65 20 74 68 69 73 2c 20 |o achiev|e this, |
|00000f70| 61 20 63 6f 75 70 6c 65 | 20 6f 66 20 6d 61 63 72 |a couple| of macr|
|00000f80| 6f 73 20 68 61 76 65 20 | 62 65 65 6e 20 64 65 66 |os have |been def|
|00000f90| 69 6e 69 65 64 2e 0a 0a | 5c 62 65 67 69 6e 7b 64 |inied...|\begin{d|
|00000fa0| 65 73 63 72 69 70 74 69 | 6f 6e 7d 0a 5c 69 74 65 |escripti|on}.\ite|
|00000fb0| 6d 7b 41 52 4f 53 5f 41 | 53 4d 53 59 4d 4e 41 4d |m{AROS_A|SMSYMNAM|
|00000fc0| 45 28 6e 29 7d 20 55 73 | 65 20 74 68 69 73 20 6d |E(n)} Us|e this m|
|00000fd0| 61 63 72 6f 20 74 6f 20 | 61 63 63 65 73 73 20 74 |acro to |access t|
|00000fe0| 68 65 20 61 73 73 65 6d | 62 6c 65 72 20 73 79 6d |he assem|bler sym|
|00000ff0| 62 6f 6c 20 7c 6e 7c 0a | 66 72 6f 6d 20 43 2e 0a |bol |n|.|from C..|
|00001000| 0a 5c 69 74 65 6d 7b 41 | 52 4f 53 5f 43 53 59 4d |.\item{A|ROS_CSYM|
|00001010| 4e 41 4d 45 28 6e 29 7d | 20 55 73 65 20 74 68 69 |NAME(n)}| Use thi|
|00001020| 73 20 6d 61 63 72 6f 20 | 74 6f 20 61 63 63 65 73 |s macro |to acces|
|00001030| 73 20 74 68 65 20 43 20 | 73 79 6d 62 6f 6c 20 7c |s the C |symbol ||
|00001040| 6e 7c 20 66 72 6f 6d 0a | 61 73 73 65 6d 62 6c 65 |n| from.|assemble|
|00001050| 72 2e 0a 0a 5c 69 74 65 | 6d 7b 41 52 4f 53 5f 43 |r...\ite|m{AROS_C|
|00001060| 44 45 46 4e 41 4d 45 28 | 6e 29 7d 20 55 73 65 20 |DEFNAME(|n)} Use |
|00001070| 74 68 69 73 20 6d 61 63 | 72 6f 20 74 6f 20 64 65 |this mac|ro to de|
|00001080| 66 69 6e 65 20 74 68 65 | 20 61 73 73 65 6d 62 6c |fine the| assembl|
|00001090| 65 72 20 73 79 6d 62 6f | 6c 20 7c 6e 7c 0a 69 6e |er symbo|l |n|.in|
|000010a0| 20 73 75 63 68 20 61 20 | 77 61 79 20 74 68 61 74 | such a |way that|
|000010b0| 20 69 74 20 63 61 6e 20 | 62 65 20 61 63 63 65 73 | it can |be acces|
|000010c0| 73 65 64 20 66 72 6f 6d | 20 43 2e 0a 0a 5c 69 74 |sed from| C...\it|
|000010d0| 65 6d 7b 41 52 4f 53 5f | 53 4c 49 42 5f 45 4e 54 |em{AROS_|SLIB_ENT|
|000010e0| 52 59 28 6e 2c 6c 29 7d | 20 55 73 65 20 74 68 69 |RY(n,l)}| Use thi|
|000010f0| 73 20 6d 61 63 72 6f 20 | 74 6f 20 67 65 74 20 74 |s macro |to get t|
|00001100| 68 65 20 6e 61 6d 65 20 | 6f 66 20 61 20 66 75 6e |he name |of a fun|
|00001110| 63 74 69 6f 6e 0a 6e 20 | 77 68 69 63 68 20 69 73 |ction.n |which is|
|00001120| 20 70 61 72 74 20 6f 66 | 20 74 68 65 20 73 68 61 | part of| the sha|
|00001130| 72 65 64 20 6c 69 62 72 | 61 72 79 20 6c 2e 0a 0a |red libr|ary l...|
|00001140| 5c 69 74 65 6d 7b 41 52 | 4f 53 5f 55 46 48 23 28 |\item{AR|OS_UFH#(|
|00001150| 2e 2e 2e 29 7d 20 55 73 | 65 20 74 68 69 73 20 6d |...)} Us|e this m|
|00001160| 61 63 72 6f 20 74 6f 20 | 64 65 63 6c 61 72 65 20 |acro to |declare |
|00001170| 61 20 66 75 6e 63 74 69 | 6f 6e 20 77 68 69 63 68 |a functi|on which|
|00001180| 20 6e 65 65 64 73 20 69 | 74 73 0a 61 72 67 75 6d | needs i|ts.argum|
|00001190| 65 6e 74 73 20 70 61 73 | 73 65 64 20 69 6e 20 72 |ents pas|sed in r|
|000011a0| 65 67 69 73 74 65 72 73 | 2e 20 23 20 69 73 20 74 |egisters|. # is t|
|000011b0| 68 65 20 6e 75 6d 62 65 | 72 20 6f 66 20 61 72 67 |he numbe|r of arg|
|000011c0| 75 6d 65 6e 74 73 20 74 | 68 65 20 66 75 6e 63 74 |uments t|he funct|
|000011d0| 69 6f 6e 0a 65 78 70 65 | 63 74 73 2e 20 54 68 65 |ion.expe|cts. The|
|000011e0| 20 70 61 72 61 6d 65 74 | 65 72 73 20 6f 66 20 74 | paramet|ers of t|
|000011f0| 68 65 20 6d 61 63 72 6f | 20 61 72 65 20 74 68 65 |he macro| are the|
|00001200| 20 72 65 74 75 72 6e 20 | 74 79 70 65 20 6f 66 20 | return |type of |
|00001210| 74 68 65 20 66 75 6e 63 | 74 69 6f 6e 2c 0a 69 74 |the func|tion,.it|
|00001220| 73 20 6e 61 6d 65 20 61 | 6e 64 20 74 68 65 20 70 |s name a|nd the p|
|00001230| 61 72 61 6d 65 74 65 72 | 73 20 69 6e 20 7c 41 52 |arameter|s in |AR|
|00001240| 4f 53 5f 55 46 48 41 28 | 29 7c 20 6d 61 63 72 6f |OS_UFHA(|)| macro|
|00001250| 73 2e 20 49 66 20 74 68 | 65 20 66 75 6e 63 74 69 |s. If th|e functi|
|00001260| 6f 6e 20 69 73 20 61 6e | 0a 61 73 73 65 6d 62 6c |on is an|.assembl|
|00001270| 65 72 20 66 75 6e 63 74 | 69 6f 6e 2c 20 79 6f 75 |er funct|ion, you|
|00001280| 20 6d 75 73 74 20 75 73 | 65 20 74 68 65 20 7c 41 | must us|e the |A|
|00001290| 52 4f 53 5f 41 53 4d 53 | 59 4d 4e 41 4d 45 28 29 |ROS_ASMS|YMNAME()|
|000012a0| 7c 20 6d 61 63 72 6f 20 | 74 6f 20 67 65 74 20 69 || macro |to get i|
|000012b0| 74 27 73 0a 6e 61 6d 65 | 2e 0a 0a 5c 69 74 65 6d |t's.name|...\item|
|000012c0| 7b 41 52 4f 53 5f 55 46 | 48 41 28 74 2c 6e 2c 72 |{AROS_UF|HA(t,n,r|
|000012d0| 29 7d 20 55 73 65 20 74 | 68 69 73 20 6d 61 63 72 |)} Use t|his macr|
|000012e0| 6f 20 74 6f 20 64 65 63 | 6c 61 72 65 20 61 20 70 |o to dec|lare a p|
|000012f0| 61 72 61 6d 65 74 65 72 | 20 66 6f 72 20 61 0a 66 |arameter| for a.f|
|00001300| 75 6e 63 74 69 6f 6e 20 | 77 68 69 63 68 20 69 73 |unction |which is|
|00001310| 20 64 65 63 6c 61 72 65 | 64 20 77 69 74 68 20 74 | declare|d with t|
|00001320| 68 65 20 7c 41 52 4f 53 | 5f 55 46 48 2a 28 29 7c |he |AROS|_UFH*()||
|00001330| 20 6d 61 63 72 6f 2e 20 | 49 74 20 74 61 6b 65 73 | macro. |It takes|
|00001340| 20 74 68 72 65 65 0a 61 | 72 67 75 6d 65 6e 74 73 | three.a|rguments|
|00001350| 3a 20 54 68 65 20 74 79 | 70 65 20 6f 66 20 74 68 |: The ty|pe of th|
|00001360| 65 20 70 61 72 61 6d 65 | 74 65 72 2c 20 74 68 65 |e parame|ter, the|
|00001370| 20 6e 61 6d 65 20 6f 66 | 20 74 68 65 20 70 61 72 | name of| the par|
|00001380| 61 6d 65 74 65 72 20 61 | 6e 64 20 74 68 65 0a 72 |ameter a|nd the.r|
|00001390| 65 67 69 73 74 65 72 20 | 74 68 65 20 70 61 72 61 |egister |the para|
|000013a0| 6d 65 74 65 72 20 69 73 | 20 65 78 70 65 63 74 65 |meter is| expecte|
|000013b0| 64 20 69 6e 2e 0a 0a 5c | 69 74 65 6d 7b 41 52 4f |d in...\|item{ARO|
|000013c0| 53 5f 55 46 43 23 28 2e | 2e 2e 29 7d 20 43 61 6c |S_UFC#(.|..)} Cal|
|000013d0| 6c 20 61 20 66 75 6e 63 | 74 69 6f 6e 20 77 68 69 |l a func|tion whi|
|000013e0| 63 68 20 6e 65 65 64 73 | 20 69 74 73 20 61 72 67 |ch needs| its arg|
|000013f0| 75 6d 65 6e 74 73 20 69 | 6e 0a 72 65 67 69 73 74 |uments i|n.regist|
|00001400| 65 72 73 2e 20 57 6f 72 | 6b 73 20 74 68 65 20 73 |ers. Wor|ks the s|
|00001410| 61 6d 65 20 77 61 79 20 | 61 73 20 7c 41 52 4f 53 |ame way |as |AROS|
|00001420| 5f 55 46 48 2a 28 29 7c | 2e 0a 0a 5c 69 74 65 6d |_UFH*()||...\item|
|00001430| 7b 41 52 4f 53 5f 4c 48 | 23 5b 49 5d 28 2e 2e 2e |{AROS_LH|#[I](...|
|00001440| 29 7d 20 55 73 65 20 74 | 68 69 73 20 6d 61 63 72 |)} Use t|his macr|
|00001450| 6f 20 74 6f 20 64 65 63 | 6c 61 72 65 20 61 20 66 |o to dec|lare a f|
|00001460| 75 6e 63 74 69 6f 6e 20 | 77 68 69 63 68 20 69 73 |unction |which is|
|00001470| 20 70 61 72 74 0a 6f 66 | 20 61 20 73 68 61 72 65 | part.of| a share|
|00001480| 64 20 6c 69 62 72 61 72 | 79 2e 20 23 20 69 73 20 |d librar|y. # is |
|00001490| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 61 72 |the numb|er of ar|
|000014a0| 67 75 6d 65 6e 74 73 20 | 74 68 65 20 66 75 6e 63 |guments |the func|
|000014b0| 74 69 6f 6e 20 65 78 70 | 65 63 74 73 2e 0a 49 66 |tion exp|ects..If|
|000014c0| 20 74 68 65 20 66 75 6e | 63 74 69 6f 6e 20 64 6f | the fun|ction do|
|000014d0| 65 73 6e 27 74 20 6e 65 | 65 64 20 74 68 65 20 6c |esn't ne|ed the l|
|000014e0| 69 62 72 61 72 79 20 62 | 61 73 65 20 70 61 73 73 |ibrary b|ase pass|
|000014f0| 65 64 2c 20 79 6f 75 20 | 63 61 6e 20 73 70 65 65 |ed, you |can spee|
|00001500| 64 20 75 70 0a 74 68 69 | 6e 67 73 20 62 79 20 61 |d up.thi|ngs by a|
|00001510| 70 70 65 6e 64 69 6e 67 | 20 22 49 22 20 74 6f 20 |ppending| "I" to |
|00001520| 74 68 65 20 6d 61 63 72 | 6f 73 20 6e 61 6d 65 2e |the macr|os name.|
|00001530| 20 54 68 65 20 70 61 72 | 61 6d 65 74 65 72 73 20 | The par|ameters |
|00001540| 6f 66 20 74 68 65 20 6d | 61 63 72 6f 20 61 72 65 |of the m|acro are|
|00001550| 0a 74 68 65 20 72 65 74 | 75 72 6e 20 74 79 70 65 |.the ret|urn type|
|00001560| 20 6f 66 20 74 68 65 20 | 66 75 6e 63 74 69 6f 6e | of the |function|
|00001570| 2c 20 69 74 73 20 6e 61 | 6d 65 2c 20 74 68 65 20 |, its na|me, the |
|00001580| 70 61 72 61 6d 65 74 65 | 72 73 20 69 6e 20 7c 41 |paramete|rs in |A|
|00001590| 52 4f 53 5f 4c 48 41 28 | 29 7c 0a 6d 61 63 72 6f |ROS_LHA(|)|.macro|
|000015a0| 73 2c 20 74 68 65 20 74 | 79 70 65 20 6f 66 20 74 |s, the t|ype of t|
|000015b0| 68 65 20 6c 69 62 72 61 | 72 79 2c 20 74 68 65 20 |he libra|ry, the |
|000015c0| 6e 61 6d 65 20 6f 66 20 | 74 68 65 20 76 61 72 69 |name of |the vari|
|000015d0| 61 62 6c 65 20 74 68 65 | 20 6c 69 62 72 61 72 79 |able the| library|
|000015e0| 20 62 61 73 65 0a 69 73 | 20 70 61 73 73 65 64 20 | base.is| passed |
|000015f0| 69 6e 2c 20 74 68 65 20 | 6f 66 66 73 65 74 20 69 |in, the |offset i|
|00001600| 6e 20 74 68 65 20 66 75 | 6e 63 74 69 6f 6e 20 74 |n the fu|nction t|
|00001610| 61 62 6c 65 20 28 31 20 | 69 73 20 74 68 65 20 66 |able (1 |is the f|
|00001620| 69 72 73 74 20 6f 66 66 | 73 65 74 20 61 6e 64 20 |irst off|set and |
|00001630| 35 0a 69 73 20 74 68 65 | 20 66 69 72 73 74 20 6f |5.is the| first o|
|00001640| 66 66 73 65 74 20 66 6f | 72 20 61 20 75 73 65 72 |ffset fo|r a user|
|00001650| 20 66 75 6e 63 74 69 6f | 6e 29 20 61 6e 64 20 74 | functio|n) and t|
|00001660| 68 65 20 6e 61 6d 65 20 | 6f 66 20 74 68 65 20 6c |he name |of the l|
|00001670| 69 62 72 61 72 79 2e 0a | 0a 5c 69 74 65 6d 7b 41 |ibrary..|.\item{A|
|00001680| 52 4f 53 5f 4c 48 41 28 | 74 2c 6e 2c 72 29 7d 20 |ROS_LHA(|t,n,r)} |
|00001690| 55 73 65 20 74 68 69 73 | 20 6d 61 63 72 6f 20 74 |Use this| macro t|
|000016a0| 6f 20 64 65 63 6c 61 72 | 65 20 61 20 70 61 72 61 |o declar|e a para|
|000016b0| 6d 65 74 65 72 20 66 6f | 72 20 61 20 66 75 6e 63 |meter fo|r a func|
|000016c0| 74 69 6f 6e 0a 77 68 69 | 63 68 20 69 73 20 64 65 |tion.whi|ch is de|
|000016d0| 63 6c 61 72 65 64 20 77 | 69 74 68 20 74 68 65 20 |clared w|ith the |
|000016e0| 7c 41 52 4f 53 5f 4c 48 | 2a 28 29 7c 20 6d 61 63 ||AROS_LH|*()| mac|
|000016f0| 72 6f 2e 20 49 74 20 74 | 61 6b 65 73 20 74 68 72 |ro. It t|akes thr|
|00001700| 65 65 20 61 72 67 75 6d | 65 6e 74 73 3a 0a 54 68 |ee argum|ents:.Th|
|00001710| 65 20 74 79 70 65 20 6f | 66 20 74 68 65 20 70 61 |e type o|f the pa|
|00001720| 72 61 6d 65 74 65 72 2c | 20 74 68 65 20 6e 61 6d |rameter,| the nam|
|00001730| 65 20 6f 66 20 74 68 65 | 20 70 61 72 61 6d 65 74 |e of the| paramet|
|00001740| 65 72 20 61 6e 64 20 74 | 68 65 20 72 65 67 69 73 |er and t|he regis|
|00001750| 74 65 72 20 74 68 65 0a | 70 61 72 61 6d 65 74 65 |ter the.|paramete|
|00001760| 72 20 69 73 20 65 78 70 | 65 63 74 65 64 20 69 6e |r is exp|ected in|
|00001770| 2e 0a 0a 5c 69 74 65 6d | 7b 41 52 4f 53 5f 4c 43 |...\item|{AROS_LC|
|00001780| 23 5b 49 5d 28 2e 2e 2e | 29 7d 20 43 61 6c 6c 20 |#[I](...|)} Call |
|00001790| 61 20 66 75 6e 63 74 69 | 6f 6e 20 77 68 69 63 68 |a functi|on which|
|000017a0| 20 69 73 20 70 61 72 74 | 20 6f 66 20 61 20 73 68 | is part| of a sh|
|000017b0| 61 72 65 64 20 6c 69 62 | 72 61 72 79 2e 0a 57 6f |ared lib|rary..Wo|
|000017c0| 72 6b 73 20 74 68 65 20 | 73 61 6d 65 20 77 61 79 |rks the |same way|
|000017d0| 20 61 73 20 7c 41 52 4f | 53 5f 4c 48 2a 28 29 7c | as |ARO|S_LH*()||
|000017e0| 2e 0a 0a 5c 69 74 65 6d | 7b 41 52 4f 53 5f 53 54 |...\item|{AROS_ST|
|000017f0| 41 43 4b 5f 47 52 4f 57 | 53 5f 44 4f 57 4e 57 41 |ACK_GROW|S_DOWNWA|
|00001800| 52 44 53 7d 20 68 61 73 | 20 74 68 65 20 76 61 6c |RDS} has| the val|
|00001810| 75 65 20 31 20 69 66 20 | 69 74 20 69 73 20 74 72 |ue 1 if |it is tr|
|00001820| 75 65 20 61 6e 64 20 30 | 0a 6f 74 68 65 72 77 69 |ue and 0|.otherwi|
|00001830| 73 65 2e 0a 0a 5c 69 74 | 65 6d 7b 41 52 4f 53 5f |se...\it|em{AROS_|
|00001840| 42 49 47 5f 45 4e 44 49 | 41 4e 7d 20 68 61 73 20 |BIG_ENDI|AN} has |
|00001850| 74 68 65 20 76 61 6c 75 | 65 20 31 20 69 66 20 74 |the valu|e 1 if t|
|00001860| 68 65 20 6d 61 63 68 69 | 6e 65 20 69 73 20 62 69 |he machi|ne is bi|
|00001870| 67 20 65 6e 64 69 61 6e | 20 28 65 67 2e 0a 41 6d |g endian| (eg..Am|
|00001880| 69 67 61 29 20 6f 72 20 | 6c 69 74 74 6c 65 20 65 |iga) or |little e|
|00001890| 6e 64 69 61 6e 20 28 65 | 67 2e 20 50 43 73 29 2e |ndian (e|g. PCs).|
|000018a0| 20 45 6e 64 69 61 6e 65 | 73 73 20 6d 65 61 6e 73 | Endiane|ss means|
|000018b0| 20 74 68 65 20 77 61 79 | 20 61 20 6e 75 6d 62 65 | the way| a numbe|
|000018c0| 72 20 69 73 0a 73 74 6f | 72 65 64 20 69 6e 20 6d |r is.sto|red in m|
|000018d0| 65 6d 6f 72 79 2e 20 41 | 6d 69 67 61 20 73 74 6f |emory. A|miga sto|
|000018e0| 72 65 73 20 7c 30 78 31 | 31 32 32 33 33 34 34 7c |res |0x1|1223344||
|000018f0| 20 61 73 20 7c 30 78 31 | 31 20 30 78 32 32 20 30 | as |0x1|1 0x22 0|
|00001900| 78 33 33 20 30 78 34 34 | 7c 20 69 6e 0a 6d 65 6d |x33 0x44|| in.mem|
|00001910| 6f 72 79 20 77 68 69 6c | 65 20 61 20 50 43 20 64 |ory whil|e a PC d|
|00001920| 6f 65 73 20 69 74 20 61 | 73 20 7c 30 78 34 34 20 |oes it a|s |0x44 |
|00001930| 30 78 33 33 20 30 78 32 | 32 20 30 78 31 31 7c 2e |0x33 0x2|2 0x11|.|
|00001940| 0a 0a 5c 69 74 65 6d 7b | 41 52 4f 53 5f 53 49 5a |..\item{|AROS_SIZ|
|00001950| 45 4f 46 55 4c 4f 4e 47 | 7d 20 54 68 65 20 72 65 |EOFULONG|} The re|
|00001960| 73 75 6c 74 20 6f 66 20 | 7c 73 69 7a 65 6f 66 28 |sult of ||sizeof(|
|00001970| 55 4c 4f 4e 47 29 7c 2e | 0a 0a 5c 69 74 65 6d 7b |ULONG)|.|..\item{|
|00001980| 41 52 4f 53 5f 57 4f 52 | 44 41 4c 49 47 4e 7d 20 |AROS_WOR|DALIGN} |
|00001990| 54 68 65 20 6d 69 6e 69 | 6d 61 6c 20 61 6c 69 67 |The mini|mal alig|
|000019a0| 6e 6d 65 6e 74 20 6f 66 | 20 31 36 62 69 74 20 6e |nment of| 16bit n|
|000019b0| 75 6d 62 65 72 73 20 69 | 6e 20 74 68 65 20 6d 65 |umbers i|n the me|
|000019c0| 6d 6f 72 79 0a 6f 66 20 | 63 6f 6d 70 75 74 65 72 |mory.of |computer|
|000019d0| 20 28 7c 57 4f 52 44 7c | 20 61 6e 64 20 7c 55 57 | (|WORD|| and |UW|
|000019e0| 4f 52 44 7c 29 2e 0a 0a | 5c 69 74 65 6d 7b 41 52 |ORD|)...|\item{AR|
|000019f0| 4f 53 5f 4c 4f 4e 47 41 | 4c 49 47 4e 7d 20 54 68 |OS_LONGA|LIGN} Th|
|00001a00| 65 20 6d 69 6e 69 6d 61 | 6c 20 61 6c 69 67 6e 6d |e minima|l alignm|
|00001a10| 65 6e 74 20 6f 66 20 33 | 32 62 69 74 20 6e 75 6d |ent of 3|2bit num|
|00001a20| 62 65 72 73 20 69 6e 20 | 74 68 65 20 6d 65 6d 6f |bers in |the memo|
|00001a30| 72 79 0a 6f 66 20 63 6f | 6d 70 75 74 65 72 20 28 |ry.of co|mputer (|
|00001a40| 7c 4c 4f 4e 47 7c 20 61 | 6e 64 20 7c 55 4c 4f 4e ||LONG| a|nd |ULON|
|00001a50| 47 7c 29 2e 0a 0a 5c 69 | 74 65 6d 7b 41 52 4f 53 |G|)...\i|tem{AROS|
|00001a60| 5f 50 54 52 41 4c 49 47 | 4e 7d 20 54 68 65 20 6d |_PTRALIG|N} The m|
|00001a70| 69 6e 69 6d 61 6c 20 61 | 6c 69 67 6e 6d 65 6e 74 |inimal a|lignment|
|00001a80| 20 6f 66 20 70 6f 69 6e | 74 65 72 73 20 69 6e 20 | of poin|ters in |
|00001a90| 74 68 65 20 6d 65 6d 6f | 72 79 20 6f 66 0a 63 6f |the memo|ry of.co|
|00001aa0| 6d 70 75 74 65 72 20 28 | 65 67 2e 20 7c 63 68 61 |mputer (|eg. |cha|
|00001ab0| 72 20 2a 7c 20 6f 72 20 | 7c 41 50 54 52 7c 29 2e |r *| or ||APTR|).|
|00001ac0| 0a 0a 5c 69 74 65 6d 7b | 41 52 4f 53 5f 44 4f 55 |..\item{|AROS_DOU|
|00001ad0| 42 4c 45 41 4c 49 47 4e | 7d 20 54 68 65 20 6d 69 |BLEALIGN|} The mi|
|00001ae0| 6e 69 6d 61 6c 20 61 6c | 69 67 6e 6d 65 6e 74 20 |nimal al|ignment |
|00001af0| 6f 66 20 36 34 62 69 74 | 20 49 45 45 45 20 66 6c |of 64bit| IEEE fl|
|00001b00| 6f 61 74 69 6e 67 20 70 | 6f 69 6e 74 0a 6e 75 6d |oating p|oint.num|
|00001b10| 62 65 72 73 20 69 6e 20 | 74 68 65 20 6d 65 6d 6f |bers in |the memo|
|00001b20| 72 79 20 6f 66 20 63 6f | 6d 70 75 74 65 72 20 28 |ry of co|mputer (|
|00001b30| 7c 64 6f 75 62 6c 65 7c | 29 2e 0a 0a 5c 69 74 65 ||double||)...\ite|
|00001b40| 6d 7b 41 52 4f 53 5f 57 | 4f 52 53 54 41 4c 49 47 |m{AROS_W|ORSTALIG|
|00001b50| 4e 7d 20 54 68 65 20 77 | 6f 72 73 74 20 70 6f 73 |N} The w|orst pos|
|00001b60| 73 69 62 6c 65 20 61 6c | 69 67 6e 6d 65 6e 74 20 |sible al|ignment |
|00001b70| 6f 66 20 61 6e 79 20 64 | 61 74 61 20 74 79 70 65 |of any d|ata type|
|00001b80| 20 69 6e 20 74 68 65 0a | 6d 65 6d 6f 72 79 20 6f | in the.|memory o|
|00001b90| 66 20 63 6f 6d 70 75 74 | 65 72 20 28 6d 6f 73 74 |f comput|er (most|
|00001ba0| 6c 79 20 74 68 65 20 73 | 61 6d 65 20 61 73 20 7c |ly the s|ame as ||
|00001bb0| 41 52 4f 53 5f 44 4f 55 | 42 4c 45 41 4c 49 47 4e |AROS_DOU|BLEALIGN|
|00001bc0| 7c 29 2e 0a 0a 5c 69 74 | 65 6d 7b 41 52 4f 53 5f ||)...\it|em{AROS_|
|00001bd0| 41 4c 49 47 4e 28 78 29 | 7d 20 47 65 74 20 74 68 |ALIGN(x)|} Get th|
|00001be0| 65 20 6e 65 78 74 20 70 | 6f 73 73 69 62 6c 65 20 |e next p|ossible |
|00001bf0| 61 64 64 72 65 73 73 20 | 77 68 65 72 65 20 6f 6e |address |where on|
|00001c00| 65 20 63 61 6e 20 70 75 | 74 20 61 6e 79 0a 64 61 |e can pu|t any.da|
|00001c10| 74 61 20 74 79 70 65 2e | 20 54 68 69 73 20 6d 61 |ta type.| This ma|
|00001c20| 63 72 6f 20 77 69 6c 6c | 20 72 65 74 75 72 6e 20 |cro will| return |
|00001c30| 7c 78 7c 20 69 66 20 61 | 6e 79 20 64 61 74 61 20 ||x| if a|ny data |
|00001c40| 74 79 70 65 20 63 61 6e | 20 62 65 20 70 75 74 20 |type can| be put |
|00001c50| 61 74 20 7c 78 7c 2e 0a | 4d 6f 73 74 20 6f 66 20 |at |x|..|Most of |
|00001c60| 74 68 65 20 74 69 6d 65 | 2c 20 74 68 69 73 20 6d |the time|, this m|
|00001c70| 61 63 72 6f 20 69 73 20 | 75 73 65 64 20 6c 69 6b |acro is |used lik|
|00001c80| 65 20 74 68 69 73 3a 20 | 47 65 74 20 61 20 62 75 |e this: |Get a bu|
|00001c90| 66 66 65 72 2c 20 70 75 | 74 20 73 6f 6d 65 20 64 |ffer, pu|t some d|
|00001ca0| 61 74 61 0a 69 6e 20 69 | 74 20 61 6e 64 20 74 68 |ata.in i|t and th|
|00001cb0| 65 6e 20 75 73 65 20 7c | 41 52 4f 53 5f 41 4c 49 |en use ||AROS_ALI|
|00001cc0| 47 4e 28 29 7c 20 74 6f | 20 66 69 6e 64 20 6f 75 |GN()| to| find ou|
|00001cd0| 74 20 77 68 65 72 65 20 | 74 68 65 20 6e 65 78 74 |t where |the next|
|00001ce0| 20 64 61 74 61 20 63 61 | 6e 20 62 65 0a 70 75 74 | data ca|n be.put|
|00001cf0| 2e 0a 0a 5c 69 74 65 6d | 7b 41 52 4f 53 5f 53 4c |...\item|{AROS_SL|
|00001d00| 4f 57 53 54 41 43 4b 54 | 41 47 53 7d 20 69 73 20 |OWSTACKT|AGS} is |
|00001d10| 64 65 66 69 6e 65 64 2c | 20 69 66 20 79 6f 75 20 |defined,| if you |
|00001d20| 6d 75 73 74 20 75 73 65 | 20 7c 47 65 74 54 61 67 |must use| |GetTag|
|00001d30| 73 46 72 6f 6d 53 74 61 | 63 6b 28 29 7c 0a 61 6e |sFromSta|ck()|.an|
|00001d40| 64 20 7c 46 72 65 65 54 | 61 67 73 46 72 6f 6d 53 |d |FreeT|agsFromS|
|00001d50| 74 61 63 6b 28 29 7c 20 | 69 6e 73 74 65 61 64 20 |tack()| |instead |
|00001d60| 6f 66 20 6a 75 73 74 20 | 70 61 73 73 69 6e 67 20 |of just |passing |
|00001d70| 74 68 65 20 61 64 64 72 | 65 73 73 20 6f 66 20 74 |the addr|ess of t|
|00001d80| 68 65 20 74 61 67 20 6f | 66 0a 74 68 65 20 66 69 |he tag o|f.the fi|
|00001d90| 72 73 74 20 74 61 67 69 | 74 65 6d 2e 0a 0a 5c 69 |rst tagi|tem...\i|
|00001da0| 74 65 6d 7b 41 52 4f 53 | 5f 53 4c 4f 57 53 54 41 |tem{AROS|_SLOWSTA|
|00001db0| 43 4b 4d 45 54 48 4f 44 | 53 7d 20 69 73 20 64 65 |CKMETHOD|S} is de|
|00001dc0| 66 69 6e 65 64 2c 20 69 | 66 20 79 6f 75 20 6d 75 |fined, i|f you mu|
|00001dd0| 73 74 20 75 73 65 0a 7c | 47 65 74 4d 73 67 46 72 |st use.||GetMsgFr|
|00001de0| 6f 6d 53 74 61 63 6b 28 | 29 7c 20 61 6e 64 20 7c |omStack(|)| and ||
|00001df0| 46 72 65 65 4d 73 67 46 | 72 6f 6d 53 74 61 63 6b |FreeMsgF|romStack|
|00001e00| 28 29 7c 20 69 6e 73 74 | 65 61 64 20 6f 66 20 6a |()| inst|ead of j|
|00001e10| 75 73 74 20 70 61 73 73 | 69 6e 67 20 74 68 65 0a |ust pass|ing the.|
|00001e20| 61 64 64 72 65 73 73 20 | 6f 66 20 74 68 65 20 6d |address |of the m|
|00001e30| 65 74 68 6f 64 20 49 44 | 2e 0a 0a 5c 65 6e 64 7b |ethod ID|...\end{|
|00001e40| 64 65 73 63 72 69 70 74 | 69 6f 6e 7d 0a 0a       |descript|ion}..  |
+--------+-------------------------+-------------------------+--------+--------+