home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / comp / sys / mac / programm / 20489 < prev    next >
Encoding:
Internet Message Format  |  1992-12-31  |  6.1 KB
  1. Path: sparky!uunet!spool.mu.edu!olivea!apple!goofy!mumbo.apple.com!gallant.apple.com!apple.com!radcliff
  2. From: radcliff@apple.com (Dave Radcliffe)
  3. Newsgroups: comp.sys.mac.programmer
  4. Subject: Re: Gestalt Selectors in APPL
  5. Message-ID: <1992Dec31.223051.15882@gallant.apple.com>
  6. Date: 31 Dec 92 22:30:51 GMT
  7. References: <BzqC31.FAM@world.std.com>
  8. Sender: news@gallant.apple.com
  9. Organization: Apple Computer
  10. Lines: 142
  11.  
  12. In article <BzqC31.FAM@world.std.com>, zobkiw@world.std.com (Joe Zobkiw) writes:
  13. > 
  14. > I need an application to install a gestalt selector. 
  15. > I know I need to load it into the System Heap but I 
  16. > have a few questions and comments.
  17. > 
  18. > 1) Can I perform a "6-byte-xdef" type trick on this 
  19. > code? I'm not sure I can since even if I mark the 
  20. > 6-byte resource as sysHeap the code it points to is 
  21. > still in my application heap.
  22. > 
  23. > 2) If I place my Gestalt selector function in a separate 
  24. > CODE resource, can I mark that resource as sysHeap and 
  25. > have it work properly? This would be WITHOUT any 6-byte 
  26. > tricks.
  27. > 
  28. > 3) How can I remove the Gestalt selector once the app 
  29. > quits? Will
  30. > 
  31. >     err = ReplaceGestalt(selector, nil, &oldGestaltFunction);
  32. > 
  33. > work or will this cause the System to jump to location 0 
  34. > the next time someone calls my selector?
  35. > 
  36. > What's the easiest way? Thanks in advance! :)
  37. > 
  38. > Joe Zobkiw
  39.  
  40. There is glue code on the January Developer CD that, assuming all you want your 
  41. Gestalt function to do is return a value, solves all your problems.  It is
  42. called GestaltValue.  The ReadMe file is pasted below:
  43.  
  44. GestaltValue Read Me
  45. ) Copyright 1992 Apple Computer, Inc.
  46. All rights reserved
  47. ------------------------------------
  48. This document describes the GestaltValue functionality as implemented in 
  49. GestaltValue.o.  Interfaces to GestaltValue are provided in 
  50. GestaltValue.h and GestaltValue.p.
  51.  
  52. GestaltValue is a set of routines, implemented as glue, that extend and 
  53. enhance existing Gestalt functionality.  For a complete description of 
  54. Gestalt, refer to Chapter 3 of Inside Macintosh VI. 
  55.  
  56. Rationale
  57.  
  58. Existing Gestalt functionality allows developers to put Gestalt to use in 
  59. their own applications by registering a Gestalt selector using the 
  60. NewGestalt or ReplaceGestalt calls, and providing a function which can 
  61. return the appropriate response.
  62.  
  63. While this is a powerful feature of Gestalt, in practice, it is difficult 
  64. to take advantage of for a number of reasons:
  65.  
  66. 1) The supplied function must entirely reside in the system heap.
  67.  
  68. 2) The function should be reentrant and not move memory because Gestalt 
  69. (and therefore the function) may be called at interrupt time.
  70.  
  71. 3) The function must effectively remain resident until restart.  This is 
  72. a problem for applications which may come and go multiple times.
  73.  
  74. 4) Since the purpose of the function is to return a response value, the 
  75. function must know how to locate, or otherwise manage that value.
  76.  
  77. All of this means a lot of work just to allow code to retrieve the response 
  78. value via Gestalt.
  79.  
  80. GestaltValue addresses all these issues.  It is built to deal with the most 
  81. common case, simply returning a 32-bit value.  It safely implements and 
  82. installs a single common, shared gestalt function and reports back values
  83. via the existing Gestalt mechanism.  This gestalt function gets installed 
  84. the first time the glue gets invoked.  Subsequent calls to the glue 
  85. (either from the same application, or a different one) cooperate with 
  86. the gestalt function to maintain a table of selectors and values for the 
  87. function to report.
  88.  
  89. GestaltValue will eventually be implemented as a standard system trap, in 
  90. which case, the glue will simply call the trap.  Although currently provided
  91. as a standalone object file, GestaltValue will eventually be rolled into 
  92. development libraries; watch for it in a development system near you.
  93.  
  94. All three GestaltValue functions defined below can move memory, so they 
  95. cannot be called at interrupt time.  But the shared gestalt function that 
  96. GestaltValue installs in the system heap is reentrant and does not move 
  97. memory (i.e., it satisfies criteria (2) above), so any values registered 
  98. via this mechanism can be safely retrieved at interrupt time via the 
  99. standard Gestalt mechanism.
  100.  
  101. Interface
  102.  
  103. Pascal:
  104.  
  105. FUNCTION NewGestaltValue(selector: OSType;newValue: LONGINT): OSErr;
  106. FUNCTION ReplaceGestaltValue(selector: OSType;replacementValue: LONGINT): OSErr;
  107. FUNCTION DeleteGestaltValue(selector: OSType): OSErr;
  108.  
  109. C:
  110.  
  111. pascal OSErr NewGestaltValue (OSType selector, long newValue);
  112. pascal OSErr ReplaceGestaltValue (OSType selector, long replacementValue);
  113. pascal OSErr DeleteGestaltValue (OSType selector);
  114.  
  115. NewGestaltValue and ReplaceGestaltValue are analogous to NewGestalt and 
  116. ReplaceGestalt.  They take a standard 4 character OSType value and a new
  117. or replacement value.  ReplaceGestaltValue has no parameter analogous 
  118. to the oldGestaltFunction parameter of ReplaceGestalt.  If you desire 
  119. saving the previous value, you should call Gestalt for that selector 
  120. before calling ReplaceGestaltValue.
  121.  
  122. The usual restrictions on the selector parameter still apply.  Apple 
  123. recommends you use your four-character creator sequence for your selector.  
  124. All lowercase letter and nonalphabetic ASCII sequences are reserved for Apple.
  125.  
  126. DeleteGestaltValue makes a Gestalt value unknown to Gestalt.  Subsequent
  127. calls to Gestalt for that selector will return gestaltUndefSelectorErr.
  128.  
  129. Return values
  130.  
  131. GestaltValue requires that the _Gestalt trap be implemented.  You will get 
  132. unimpErr (-4) if _Gestalt is unavailable.
  133.  
  134. NewGestaltValue returns gestaltDupSelectorErr (-5552) if you attempt to add 
  135. a new value for an existing selector.  You should use ReplaceGestaltValue 
  136. instead.
  137.  
  138. ReplaceGestaltValue returns gestaltUndefSelectorErr (-5551) if you attempt 
  139. to replace a non-existent selector.  You should use NewGestaltValue instead.
  140.  
  141. Both NewGestaltValue and ReplaceGestalt value may return memory errors if 
  142. they cannot allocate sufficient room in the system heap for their code and 
  143. data.
  144.  
  145. DeleteGestaltValue returns gestaltUndefSelectorErr if you attempt to delete 
  146. a selector unknown to GestaltValue (such as a pre-defined gestalt selector 
  147. such as 'fpu ').
  148. ----
  149. I hope this helps.  Have fun,
  150.  
  151. Dave Radcliffe
  152. Apple Computer
  153. MacDTS
  154.