Reads DIO direction, input or output memory per DIO channel
GX1649, GX1649-1
GxAoDioReadChannelMemory (nHandle, nChannel, nMemoryType, pucVector, dwSize, pnStatus)
Name |
Type |
Description |
nHandle |
SHORT |
Handle to a GX1649 board. |
nChannel |
SHORT |
DIO Channel (0-7) |
nMemoryType |
SHORT |
Type of Memory to read from:0. GX1649_DIO_MEMORY_INPUT_TYPE: Write to DIO Input Memory1. GX1649_DIO_MEMORY_OUTPUT_TYPE: Write to DIO Output Memory2. GX1649_DIO_MEMORY_DIRECTION_TYPE: Write DIO Direction Memory |
pucVector |
PBYTE |
Buffer to hold the returned array of bytes that represent the memory states. Buffer size used is specified using the dwSize parameter. |
dwSize |
DWORD |
The number of vectors to read from memory. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
Each element in the byte array represents the direction, input or output state of one DIO channel. A value of 0 or 1 is returned for each element as specified by nMemoryType:
GX1649_DIO_MEMORY_INPUT_TYPE: 1 represents a recorded logic high, and 0 represents a recorded logic low
GX1649_DIO_MEMORY_OUTPUT_TYPE: 1 represents a logic high output, and 0 represents a logic low output
GX1649_DIO_MEMORY_DIRECTION_TYPE: 1 represents output and a 0 represents input.
The following example reads 1000 vectors from the input output DIO memory of channel 5:
SHORT nStatus;
BYTE aucVector[1000];
GxAoDioReadChannelMemory (nHandle, 5, GX1649_DIO_MEMORY_INPUT_TYPE, aucVector, 1000, &nStatus);
GxAoDioReadMemory, GxAoDioWriteChannelMemory, GxAoDioGetVectorCount, GxAoGetErrorString