meiPlatformMemoryGet64

Declaration

	long meiPlatformMemoryGet64(MEIPlatform platform, void dst, const void src)
	Required Header: stdmei.h Change History: Added in the 03.04.00

Description

meiPlatformMemoryGet64 gets (reads) 8 bytes of platform memory (starting at address src) to application memory (starting at address dst).

This function should be used to get/read any 64-bit data from the controller. This function can take up to one foreground cycle to complete. This function will take a platform lock blocking all other tasks from accessing the controller.

platform	the handle to the controller's platform object.
*dst	address of host data storage area. Storage MUST be two words (64 bits).
*src	address of data (in host space) on the controller to be read.

Returns
MPIMessageOK
MEIPlatformMessageDEVICE_ERROR	The board type is not an XMP or ZMP controller. 64-bit data is only supported on XMP and ZMP controllers.
MEIPlatformMessageCOPY64_FAILURE	The 64-bit value could not be read successfully.
MPIMessageFATAL_ERROR	The platform type does not exist.

Sample Code


...
/* axisPosition.actual is defined as MEIInt64 which is 64 bits */

if (returnValue == MPIMessageOK) {
  returnValue = meiPlatformMemoryGet64(axis->platform,
                                       &axis->axisPosition.actual,
                                       &axis->Axis->ActualPosition);
}

if (returnValue == MPIMessageOK) {
  *actual = (double)axis->axisPosition.actual;
}
...