beautypg.com

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

Page 54

background image

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

54 PanelView Plus CE-Specific Extensions to the WinCE API

Return Values:

Remarks:

This function provides “one-shot” behavior. The application must
restart the timer if “periodic” behavior is desired. See
UserTimerSetEx() below.

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 or the RAC6182.

Requirements:

UserTimerSetEx

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

DWORD UserTImerSetEx (DWORD dwTimerNumber, DWORD
dwCount, DWORD dwMode)

UserTimerSet - Return Codes

Value

Description

USER_TIMER_OK

The countdown was set and the timer started.

USER_TIMER_INVALID_TIMER

The timer number is not valid for the system.

USER_TIMER_INVALID_PARAMETER

dwCount was 0.

USER_TIMER_NOT_CLAIMED

This application has not claimed this timer.

USER_TIMER_SET_FAILED

Unable to set countdown value.

Runs On

Version

Defined In

Link To

PanelView Plus CE

RAC6182

All

usertimers.h

usertimers.lib