File.
Writes Ignore data from a DIO file.
DioFileReadIgnoreData (hFile, pvIgnore, dwStart, dwSize, pnStatus)
Name |
Type |
Comments |
hFile |
SHORT |
File board handle returned by the function DioFileOpen. |
pvIgnore |
PVOID |
Pointer to an array, array data type needs to comply with the file width settings and board type, see comments for details. |
dwStart |
DWORD |
Starting step to read from. |
dwSize |
DWORD |
Number of steps to read. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The ignore data sets the specified range of channels steps to either be ignored or not. A bit low means do not ignore, bit high means ignore. The ignore data has dual use:
● Using any Gx5290 family member the ignore data is being used specified channels steps to Hi-Z. When a channel step direction is set to output and ignore bit is set to high, upon loading the vector that channel step direction will be set as input.
● Comparing two DIO files channels steps with ignore bits set to high will not be compared.
The following example writes 64 steps from the file:
DWORD adwIgnoreData [64];
DioFileWriteIgnoreData (hFile, adwIgnoreData, 0, 64, &nStatus);
DioFileReadIgnoreData, DioWritedOutMemory, DioWriteDirectionMemory, DioGetErrorString