File.
Sets the specified file load options.
DioFileSetLabelOptions (hFile, dwFileLoadOptions, pnStatus)
Name |
Type |
Comments |
hFile |
SHORT |
File board handle returned by the function DioFileOpen. |
dwFileLoadOptions |
DWORD |
File load options:0. DIO_FILE_LOAD_ALL_DOMAIN_RESET_ON_FILE_LOAD: default settings, in this mode all the data and settings will be loaded and applied to the hardware. As well as reset the domain.1. DIO_FILE_NO_DOMAIN_RESET_ON_FILE_LOAD: setting this flag will not reset all the boards in the domain before loading the new settings from the DIO file (default is to always reset the domain). This may be used to prevent I/O levels to change when loading consecutive vector files.2. DIO_FILE_LOAD_DATA_ONLY: settings this flag will only load the file data to the boards’ in the domain.4. DIO_FILE_LOAD_SETTINGS_ONLY: settings this flag will only load the file settings to the boards’ in the domain. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The following example sets the load data only flag:
SHORT nStatus, hFile;
DioFileOpen (szfilename, 1, &hFile, &nStatus);
if (hFile!=0 && nStatus==0)
DioFileSetLoadOptions (hFile, DIO_FILE_LOAD_DATA_ONLY, &nStatus);