niFgen_AllocateNamedWaveform
ViStatus niFgen_AllocateNamedWaveform (ViSession vi, ViConstString channelName, ViConstString waveformName, ViInt32 waveformSize);
Purpose
Specifies the size of a named waveform up front so that it can be allocated in onboard memory before loading the associated data. Data can then be loaded in smaller blocks with the niFgen Write (Binary16) Waveform functions.
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 allocate the named waveform.
Default Value: "0" |
| waveformName | ViConstString | Specifies the name to associate with the allocated waveform. |
| waveformSize | ViInt32 | Specifies the size of the waveform to allocate in samples. |
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:
|