DDS11 — R#182) Clarify mapping of PIM 'out' to PSM 'inout'

There is already a convention in the specification of mapping an out parameter in the PIM to an inout parameter in the IDL PSM. This convention is useful because it preserves more precise semantics in the PIM while allowing for more performant implementations in language PSMs based on the IDL PSM. However, the convention is never explicitly described in the specification, which could lead to confusion among readers.

Proposed Resolution:

The section 2.2.2 PIM to PSM Mapping Rules should explicitly describe and endorse the aforementioned convention.

Proposed Revised Text:

Insert a new paragraph after the current first paragraph in section 2.2.2:
'Out' parameters in the PIM are conventionally mapped to 'inout' parameters in the PSM in order to minimize the memory allocation performed by the Service and allow for more efficient implementations. The intended meaning is that the caller of such an operation should provide an object to serve as a "container" and that the operation will then "fill in" the state of that object appropriately.

No Data Available