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

Publication 2711P-UM005A-EN-P - March 2007
PanelView Plus CE-Specific Extensions to the WinCE API 55
Parameters:
dwTimerNumber
The Timer Number is 0 based; i.e., if 2 timers are present on the
system, they are timer 0 and timer 1. When specifying a critical timer,
the flag USERTIMER_CRITICAL must be or’d with the Timer Number.
The range is 0 to MAX_TIMER_NUMBER.
dwCount
A DWORD value that sets the countdown value and starts the timer.
The frequency of the timer is the last frequency returned from
UserTimerRequestFrequency().
dwMode
When FALSE (zero), the timer operates as a one shot. Otherwise,
when TRUE (non zero), the timer operates in periodic mode.
Return Values:
Same as Table .
Remarks:
This API is an extension of the UserTimerSet() function in that it
allows the timer to be configured for periodic or one-shot operation.
Any count in progress is aborted by this function.
USER_TIMER_SET_FAILED indicates that the count may be beyond
the hardware capabilities of the timers and may be out of range, or
the frequency had not been set.
Portability:
This function is specific to the PanelView Plus CE.
Requirements:
Runs On Version Defined In Link To
PanelView Plus CE All usertimers.h usertimers.lib