Collaboration diagram for Write memory area:

Functions
MLPIRESULT	mlpiLogicWriteMemoryAreaBool8 (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG bitOffset, const BOOL8 data)

MLPIRESULT	mlpiLogicWriteMemoryAreaChar (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const CHAR data)

MLPIRESULT	mlpiLogicWriteMemoryAreaUchar (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const UCHAR data)

MLPIRESULT	mlpiLogicWriteMemoryAreaShort (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const SHORT data)

MLPIRESULT	mlpiLogicWriteMemoryAreaUshort (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const USHORT data)

MLPIRESULT	mlpiLogicWriteMemoryAreaLong (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const LONG data)

MLPIRESULT	mlpiLogicWriteMemoryAreaUlong (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const ULONG data)

MLPIRESULT	mlpiLogicWriteMemoryAreaLlong (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const LLONG data)

MLPIRESULT	mlpiLogicWriteMemoryAreaUllong (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const ULLONG data)

MLPIRESULT	mlpiLogicWriteMemoryAreaFloat (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const FLOAT data)

MLPIRESULT	mlpiLogicWriteMemoryAreaDouble (const MLPIHANDLE connection, const WCHAR16 *application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const DOUBLE data)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayChar (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const CHAR data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayUchar (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const UCHAR data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayShort (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const SHORT data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayUshort (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const USHORT data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayLong (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const LONG data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayUlong (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const ULONG data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayLlong (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const LLONG data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayUllong (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const ULLONG data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayFloat (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const FLOAT data, const ULONG numElements)

MLPIRESULT	mlpiLogicWriteMemoryAreaArrayDouble (const MLPIHANDLE connection, const WCHAR16 application, const MlpiApplicationMemoryArea area, const ULONG byteOffset, const DOUBLE data, const ULONG numElements)

Detailed Description

These functions write the following memory areas: "%Ix" (Input), "%Qx" (Output) and "%Mx" (Marker)

The table shows the PLC data types within the IEC61131 environment 'IndraLogic' and the corresponding data types within the C/C++ environment (e.g. 'Workbench OEM') of the MLPI. On writing to memory areas, on default, you use the functions below named after the MLPI data type like mlpiLogicWriteMemoryAreaUllong. If you include the header mlpiLogicHelper.h, you can also use the equivalent functions named after the IEC61131 data types like mlpiLogicWriteMemoryAreaLword or like mlpiLogicWriteMemoryAreaUlint.

Note: Reading on outputs and writing on inputs is not supported yet.

Number of Bits	Data types of PLC	Data types of MLPI
8	BOOL	BOOL8
8	SINT	CHAR
16	INT	SHORT
32	DINT	LONG
64	LINT	LLONG
8	USINT	UCHAR
16	UINT	USHORT
32	UDINT	ULONG
64	ULINT	ULLONG
8	BYTE	UCHAR
16	WORD	USHORT
32	DWORD	ULONG
64	LWORD	ULLONG
32	REAL	FLOAT
64	LREAL	DOUBLE
8n	STRING	WCHAR16
16n	WSTRING	WCHAR16

Function Documentation

MLPIRESULT mlpiLogicWriteMemoryAreaBool8	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	bitOffset,
		const BOOL8	data
	)

This function writes a Boolean value e.g. a bit (BOOL8, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	bitOffset	Bit offset based on zero (e.g. QX0.0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QX1.5.
2 BOOL8 data = TRUE;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaBool8(connection, application, MLPI_MEMORY_AREA_OUTPUT, 13, data);

MLPIRESULT mlpiLogicWriteMemoryAreaChar	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const CHAR	data
	)

This function writes the 8-bit signed data value (SINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QB42.
2 CHAR data = -1;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaChar(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaUchar	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const UCHAR	data
	)

This function writes the 8-bit unsigned data value (BYTE, USINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QB42.
2 UCHAR data = 1;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaUchar(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaShort	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const SHORT	data
	)

This function writes the 16-bit signed data value (INT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QW42.
2 SHORT data = -18;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaShort(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaUshort	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const USHORT	data
	)

This function writes the 16-bit unsigned data value (WORD, UINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QW42.
2 USHORT data = 18;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaUshort(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaLong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const LONG	data
	)

This function writes the 32-bit signed data value (DINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QD42.
2 LONG data = -42;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaLong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaUlong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const ULONG	data
	)

This function writes the 32-bit unsigned data value (DWORD, UDINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QD42.
2 ULONG data = 42;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaUlong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaLlong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const LLONG	data
	)

This function writes the 64-bit signed data value (LINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QL42.
2 LLONG data = -13;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaLlong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaUllong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const ULLONG	data
	)

This function writes the 64-bit unsigned data value (LWORD, ULINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QL42.
2 ULLONG data = 13;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaUllong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaFloat	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const FLOAT	data
	)

This function writes the 32-bit floating point data value (single precision, REAL, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QD42.
2 FLOAT data = 1.234;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaFloat(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaDouble	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const DOUBLE	data
	)

This function writes the 64-bit floating point data value (double precision, LREAL, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Variable which contains the value that should be written.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data value to the memory area %QL42.
2 DOUBLE data = 1.23456789;
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaDouble(connection, application, MLPI_MEMORY_AREA_OUTPUT, 42, data);

MLPIRESULT mlpiLogicWriteMemoryAreaArrayChar	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const CHAR *	data,
		const ULONG	numElements
	)

This function writes an array of 8-bit signed data values (SINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of CHAR elements in 'data*' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IB0 to %IB1.
2 CHAR data[] = {-1, 2};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayChar(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayUchar	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const UCHAR *	data,
		const ULONG	numElements
	)

This function writes an array of 8-bit unsigned data values (BYTE, USINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of UCHAR elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IB0 to %IB1.
2 UCHAR data[] = {1, 85};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayUchar(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayShort	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const SHORT *	data,
		const ULONG	numElements
	)

This function writes an array of 16-bit signed data values (INT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of SHORT elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IW0 to %IW2.
2 SHORT data[] = {-18, 65};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayShort(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayUshort	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const USHORT *	data,
		const ULONG	numElements
	)

This function writes an array of 16-bit unsigned data values (WORD, UINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of USHORT elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IW0 to %IW2.
2 USHORT data[] = {18, 33};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayUshort(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayLong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const LONG *	data,
		const ULONG	numElements
	)

This function writes an array of 32-bit signed data values (DINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of LONG elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %ID0 to %ID4.
2 LONG data[] = {-42, 99};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayLong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayUlong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const ULONG *	data,
		const ULONG	numElements
	)

This function writes an array of 32-bit unsigned data values (DWORD, UDINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of ULONG elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %ID0 to %ID4.
2 ULONG data[] = {42, 55};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayUlong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayLlong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const LLONG *	data,
		const ULONG	numElements
	)

This function writes an array of 64-bit signed data values (LINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of LLONG elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IL0 to %IL8.
2 LLONG data[] = {-13, 44};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayLlong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayUllong	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const ULLONG *	data,
		const ULONG	numElements
	)

This function writes an array of 64-bit unsigned data values (LWORD, ULINT, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of ULLONG elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IL0 to %IL8.
2 ULLONG data[] = {13, 77};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayUllong(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayFloat	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const FLOAT *	data,
		const ULONG	numElements
	)

This function writes an array of 32-bit floating point data values (single precision, REAL, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of FLOAT elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %ID0 to %ID4.
2 FLOAT data[] = {1.234, 9.907};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayFloat(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

MLPIRESULT mlpiLogicWriteMemoryAreaArrayDouble	(	const MLPIHANDLE	connection,
		const WCHAR16 *	application,
		const MlpiApplicationMemoryArea	area,
		const ULONG	byteOffset,
		const DOUBLE *	data,
		const ULONG	numElements
	)

This function writes an array of 64-bit floating point data values (double precision, LREAL, MlpiLogicType) to the memory area (MlpiApplicationMemoryArea).

Parameters

[in]	connection	Handle for multiple connections.
[in]	application	Name of application.
[in]	area	Memory area of access (MlpiApplicationMemoryArea).
[in]	byteOffset	Byte offset based on zero (e.g. QB0).
[in]	data	Pointer to variable which contains the values that should be written.
[in]	numElements	Number of DOUBLE elements in 'data' available to write.

Returns: Return value indicating success (>=0) or error (<0).

Example:: 1 // Writes the data values to the memory area %IL0 to %IL8.
2 DOUBLE data[] = {1.23456789, 9.87654321};
3 WCHAR16 application = L"Application";
4 MLPIRESULT result = mlpiLogicWriteMemoryAreaArrayDouble(connection, application, MLPI_MEMORY_AREA_OUTPUT, 0, data, _countof(data));

Functions

Detailed Description

Function Documentation