Memory Usage

The log function is one of the very few functions in WMX3 that require dynamic access to memory in the RTX space. The dynamic memory allocation occurs when calling SetLog. If there is not enough memory in RTX space, this function will return an error and the log operation will be unable to be started. For additional information, see Function Calls Related to Memory Allocation.

The maximum amount of memory that can be allocated to one log channel is maxLogBufferSize bytes. If the amount of memory required to buffer the log data exceeds this value, the LogBufferOpenFailed error is returned by the SetLog function. Even if the required amount of memory is less than maxLogBufferSize, the LogBufferOpenFailed error may be returned if memory allocation fails (for example, if there is not enough contiguous memory available).

See the tables in Loggable Data for information regarding how much buffer memory is required to log each data.