meiSqNodeDigitalInPtr

Declaration

	long meiSqNodeDigitalInPtr(MEISqNode sqNode, long bit, long mask, long *ptr);
	Required Header: stdmei.h Change History: Added in the 03.04.00.

Description

meiSqNodeDigitalInPtr gets a controller memory pointer and mask of a digital input (bit on the SynqNet node sqNode) and writes them to the locations pointed to by ptr and mask. The memory pointer and mask obtained by this function can be used when setting up the data recorder or user limits.

sqNode	a handle to a SynqNet node object.
bit	an index to a node's digital input bit.
*mask	a pointer to a bitwise mask that corresponds to the specified bit.
**ptr	a pointer to a controller address that contains the digital input bit.

Return Values
MPIMessageOK
MPIMessageaARG_INVALID

Sample Code

The sample code below shows how to set up the data recorder to record bit 5 on node 1.


long mask;
long * pointer;
meiSqNodeDigitalInPtr( sqNode1, 5, &mask, &pointer );

void * points[MEIXmpMaxRecSize];
points[0] = pointer;
long pointCount = 1;
mpiRecorderRecordConfig(
   recorder,
   MPIRecorderRecordTypePOINT,
   pointCount,
   points );