Renesas Stub Generator V.1.00 - Manual (Page 72)

Section 6 Definitions of Server Functions
Rev. 1.01 Mar. 17, 2008 Page 60 of 128
REJ10J1822-0101
6.5.4 REF (Passing by Reference)
Description:
This keyword specifies that only the address of the parameter will be passed between the client
and the server. REF is useful when the size of the parameter to be passed is large.
This keyword can be used in conjunction with IN and with the data-type keywords PTR, STR, and
ARY.
Figure 6.1 illustrates the difference between cases with and without REF.
[IN PTR] struct ST *ptr
[IN REF PTR] struct ST *ptr
ptr
Parameter to be
passed to the
server function
ptr
Copying
struct ST
struct ST
ptr
struct ST
ptr
Parameter specified in the client
Parameter specified in the client
Server parameter area
(in a non-cacheable area)
Server parameter area
(in a non-cacheable area)
Copying
Parameter to be
passed to the
server function
Client area
Client area*
*Note: When the device in use does not provide a facility for cache-snooping
between the CPU cores (as is the case for the SH2A-DUAL etc.), the server
parameter area must be allocated in a non-cacheable area.
Figure 6.1 REF