beautypg.com

Read or write system parameters, Rm_getparameter, Read or write system parameters rm_getparameter – Rockwell Automation 2711P Software Development Kit User Manual User Manual

Page 45

background image

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

PanelView Plus CE-Specific Extensions to the WinCE API 45

• RM_PARAMETER_BOARD_REVISION

This parameter reads the logic board revision number, which
is managed by a set of 4 pull-up resistors on the board. The
revision number is returned as a simple integer in the range 0
to 15.

Most system parameters are only used to obtain the return
value on get or pass the argument value on set. An exception
is RM_PARAMETER_PHYSICAL_ADDRESS as follows:

• RM_PARAMETER_PHYSICAL_ADDRESS

This parameter allows getting the physical address
corresponding to a virtual address valid in the current process
space. Because of this, the parameter should be passed in
pointing to the desired virtual address. Upon successful return
this value will be replaced with the physical address.

Read or Write System Parameters

These functions permit an application to read or write the System
Parameters.

rm_GetParameter

This function gets a System Parameter.

DWORD rm_GetParameter (DWORD dwParameter, DWORD
*pdwSize, VOID *pvData);

Parameters:

dwParameter

This parameter must be one of the values in Table .

pdwSize

A pointer to a passed value that indicates the number of bytes in the
buffer, pvData. Upon success, dwSize returns the number of bytes
actually returned in the buffer.

pvData

A pointer to a buffer.