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

Publication 2711P-UM005A-EN-P - March 2007
PanelView Plus CE-Specific Extensions to the WinCE API 49
Requirements:
UserTimerClaim
This function is used to claim or release exclusive access to a specific
timer.
DWORD UserTimerClaim (DWORD dwTimerNumber, BOOL
bClaim);
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.
bClaim
TRUE to claim access to a timer, and FALSE to release it.
Return Values:
Runs On Version Defined In Link To
PanelView Plus CE
RAC6182
All usertimers.h usertimers.lib
UserTimerClaim - Return Codes
Value Description
USER_TIMER_OK Successfully claimed or released timer.
USER_TIMER_INVALID_TIMER The timer number is not valid for the system.
USER_TIMER_NOT_CLAIMED Another application already claimed the timer so
this application could not claim it.
USER_TIMER_ALREADY_CLAIMED This application has already claimed this timer.