Rockwell Automation 2711P Software Development Kit User Manual - Manual (Page 65)

Publication 2711P-UM005A-EN-P - March 2007
PanelView Plus CE-Specific Extensions to the WinCE API 65
hm_GetMonitorWarningLevels
This function gets the high and low warning levels for a specific
monitored parameter.
BOOL hm_GetMonitorWarningLevels (DWORD dwMonitorID,
DOUBLE *plfUpperWarningLevel, DOUIBLE
*plfLowerWarningLevel);
Parameters:
dwMonitorID
A value from Table .
lfUpperWarningLevel
A pointer to a double precision floating-point value that returns the
upper bound of the monitor parameter during normal operation.
Some parameters return MONITOR_WARNING_LEVEL_UNDEFINED
to indicate that the upper bound is undefined and not used to
determine if the parameter enters the warning state. See Remarks.
lfLowerWarningLevel
A pointer to a double precision floating-point value that defines the
lower bound of the monitor parameter during normal operation. Some
parameters return MONITOR_WARNING_LEVEL_UNDEFINED to
indicate that the lower bound is undefined and not used to determine
if the parameter enters the warning state. This is a requirement for
some parameters. See Remarks.
Return Values:
Returns TRUE if the warning levels were successfully returned;
otherwise, FALSE on failure.
Remarks:
Upper and lower warning levels specify the upper and lower bounds
of the monitored parameter during normal operation. If the parameter
deviates from the specified operating bounds, it enters the warning
state. Upper and lower warning levels are set by default or by
hm_SetMonitorWarningLevels () and can be obtained using this
function.