RtfwGetMonitorConfiguration

RtfwGetMonitorConfiguration returns the most-recently configured wRTOS Monitoring configuration parameters.

Syntax

Copy

bool RtfwGetMonitorConfiguration(
    [out]   RTFW_MONITOR_CONFIGURATION * pMonitorConfiguration
);

Parameters

[out] pMonitorConfiguration

A pointer to a structure RTFW_MONITOR_CONFIGURATION that is set to the default Monitoring configuration. The member Size must be set to sizeof(RTFW_MONITOR_CONFIGURATION), otherwise this function fails and sets the last error value to RT_ERROR_STRUCTURE_TOO_SMALL.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE, sets the last error value, and leaves the structure pointed to with invalid data. Call GetLastError to obtain an error code.

Possible error codes:

Error code	Meaning
RT_ERROR_STRUCTURE_TOO_SMALL	The member Size of a structure is too small.

Remarks

If the Subsystem is running when the RtfwSetMonitorConfiguration API is called, the values returned by this function may differ from the values currently in use by the Subsystem.

If the Subsystem is running when the RtfwGetLocalMemoryConfiguration API is called, the values returned by this function may differ from the values currently in use by the Subsystem.

Requirements

Minimum supported version	Header	Library
wRTOS 1.0 SDK	RtfwApi.h	RtfwApi.lib