DioReadXRegister

DioWriteXRegister

Applies To

GC5050, GX5050, GX5150, GX5280, GX5290, GX5290e, GX5295, File

Purpose

Reads or Writes the X register to/from the specified Master board.

Syntax

DioReadXRegister (nMasterHandle, pwData, pnStatus)

DioWriteXRegister (nMasterHandle, wData, pnStatus)

Parameters

Name	Type	Comments
nMasterHandle	SHORT	Master board or File board handle.
pwData	PWORD	Returned X register value.
wData	WORD	Register X value to be written.
pnStatus	PSHORT	Returned status: 0 on success, negative number on failure.

Comments

This function is used to simulate external event line values. DioSetupTriggerXEventSource must be called in order to simulate the external event lines.

Example

The following example sets the X register event source to internal, writes to the X register the value 0xA5A5, and reads it back from the X register to verify its content:

SHORT nStatus;

WORD wData;

DioSetupTriggerXEventSource(nMasterHandle, 1, &nStatus);

DioWriteXRegister(nMasterHandle, 0xA5A5, &nStatus);

DioReadXRegister(nMasterHandle, &wData, &nStatus);