niFgen_CreateWaveformFromFileF64
ViStatus niFgen_CreateWaveformFromFileF64 (ViSession vi, ViConstString channelName, ViConstString filename, ViInt32 byteOrder, ViInt32* waveformHandle);
Purpose
This function takes the F64 (floating point double) data from the specified file and creates an onboard waveform for use in Arbitrary Waveform or Arbitrary Sequence output mode. The waveformHandle returned can later be used for setting the active waveform, changing the data in the waveform, building sequences of waveforms, or deleting the waveform when it is no longer needed.
Notes The F64 data must be between -1.0 and +1.0 V. Use the NIFGEN_ATTR_DIGITAL_GAIN attribute to generate different voltage outputs. | |
You must call the niFgen_ConfigureOutputMode function to set the outputMode parameter to NIFGEN_VAL_OUTPUT_ARB or NIFGEN_VAL_OUTPUT_SEQ before calling this function. |
Parameters
Input | ||||||||
Name | Type | Description | ||||||
vi | ViSession | Identifies your instrument session. vi is obtained from the niFgen_init or the niFgen_InitWithOptions functions and identifies a particular instrument session. | ||||||
channelName | ViConstString | Specifies the channel name for which you want to create the waveform.
Defined Value: "0" Default Value: "0" |
||||||
fileName | ViConstString | The full path and name of the file where the waveform data resides. |
||||||
byteOrder | ViInt32 | Specifies the byte order of the data in the file.
Defined Values
Default Value: NIFGEN_VAL_LITTLE_ENDIAN |
||||||
Output | ||||||||
Name | Type | Description | ||||||
waveformHandle | ViInt32* | The handle that identifies the new waveform. This handle is used later when referring to this waveform. |
Return Value
Name | Type | Description | ||||||||
Status | ViStatus | Returns the status code of this operation. The status code either indicates success or describes an error or warning condition. You can examine the status code from each call to an NI-FGEN function to determine if an error occurred.
To obtain a text description of the status code, call the niFgen_error_message function. To obtain additional information about the error condition, call the niFgen_GetError function. To clear the error information from NI-FGEN, call the niFgen_ClearError function. The general meaning of the status code is as follows:
|