beautypg.com

Run timer functions, Usertimerset, Run timer functions usertimerset – Rockwell Automation 2711P Software Development Kit User Manual User Manual

Page 53

background image

Publication 2711P-UM005A-EN-P - March 2007

PanelView Plus CE-Specific Extensions to the WinCE API 53

Calling this API a second time with the same timer number and the
same state for bManualReset will result in the API returning the same
handle as was provided on the first call. If the state of bManualReset is
different, the API will fail.

Portability:

This function is specific to the PanelView Plus CE or the RAC6182.

Requirements:

Run Timer Functions

These functions permit an application to start and stop the timer, and
to set the countdown value.

UserTimerSet

This function sets the count of a claimed timer and start timing the
countdown.

DWORD UserTimerSet (DWORD dwTimerNumber, DWORD
dwCount);

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(). The countdown stops and the timer is
triggered at 0.

Runs On

Version

Defined In

Link To

PanelView Plus CE

RAC6182

All

usertimers.h

usertimers.lib