beautypg.com

Usertimerrequestfrequency – Rockwell Automation 2711P Software Development Kit User Manual User Manual

Page 50

background image

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

50 PanelView Plus CE-Specific Extensions to the WinCE API

Remarks:

A timer must be claimed for any other function that takes a
TimerNumber as a parameter to be used. A timer must be released to
allow any other application to claim and use the timer.

The mechanism will support a system that has multiple critical timers.

When releasing a timer, any handle created from
UserTimerGetWaitEvent() is closed by this operation. The user should
not close the handle.

Portability:

The RAC6182 does not have a critical timer; hence the attribute
USERTIMER_CRITICAL is not supported on the RAC6182.

Requirements:

UserTimerRequestFrequency

This function sets the frequency of a claimed timer.

DWORD UserTimerRequestFrequency (DWORD
dwTimerNumber, DWORD *pdwFrequency);

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.

Runs On

Version

Defined In

Link To

PanelView Plus CE

RAC6182

All

usertimers.h

usertimers.lib