optimize attribute

The [optimize] ACF attribute is used to fine tune the level of gradation for marshaling data.

Note

This keyword is superceeded and should not be used. Current MIDL compilations should use /Oicf/robust instead.

 

optimize ("optimization-options")

Parameters

optimization-options

Specifies the method of marshaling data. Use either "s" for mixed-mode marshaling or "i" for interpreted marshaling.

Remarks

This version of RPC provides two methods for marshaling data: mixed-mode ("s") and interpreted ("i"). These methods correspond to the /Os and /Oi command-line switches. The interpreted method marshals data completely offline. While this can reduce the size of the stub considerably, performance can be affected.

If performance is a concern, the mixed-mode method can be the best approach. Mixed-mode allows the MIDL compiler to make the determination between which data will be marshaled inline and which will be marshaled by a call to an offline dynamic-link library. If many procedures use the same data types, a single procedure can be called repeatedly to marshal the data. In this way, data that is most suited to inline marshaling is processed inline while other data can be more efficiently marshaled offline.

Note that the [optimize] attribute can be used as an interface attribute or as an operation attribute. If it is used as an interface attribute, it sets the default for the entire interface, overriding command-line switches. If, however, it is used as an operation attribute, it affects only that operation, overriding command-line switches and the interface default.

Examples

optimize ("s") HRESULT FasterProcedure(...); 
optimize ("i") HRESULT SmallerProcedure(...);

See also

Application Configuration File (ACF)

/Oi

/Os

/robust