beautypg.com

ProSoft Technology MVI56E-LDM User Manual

Page 198

background image

CIP API Functions

ControlLogix Platform ♦ "C" Programmable

Developer's Manual

Linux Application Development Module

Page 192 of 264

ProSoft Technology, Inc.

March 12, 2014

OCXcip_SetDisplay

Syntax

int OCXcip_SetDisplay (OCXHANDLE apihandle,

char * display_string);

Parameters

apihandle

handle returned by previous call to OCXcip_Open

display_string

4-character string to be displayed

Description

OCXcip_SetDisplay

allows and application to load 4 ASCII characters to the

alphanumeric display.

apihandle

must be a valid handle returned from

OCXcip_Open

.

display_string

must be a pointer to a NULL-terminating string whose length is

exactly 4 (no including the NULL).

Return Value

OCX_SUCCESS

The display was set successfully

OCX_ERR_NOACCESS

apihandle

does not have access

OCX_ERR_BADPARAM

display_string length is not 4

Example

OCXHANDLE apiHandle;
char buf[5];

/* Display the time as HHMM */

OCXcip_SetDisplay (apiHandle, buf);