niRFSG Allocate Arb Waveform

Allocates onboard memory space for the arbitrary waveform. Use this VI to specify the total size of a waveform before writing the data. You only need to use this VI if you are calling the niRFSG Write Arb Waveform VI multiple times to write a large waveform in smaller blocks. The NI-RFSG device must be in the Configuration state before you call this VI.

Supported Devices: NI 5670/5671/5672

Details

	instrument handle identifies your instrument session. instrument handle is obtained from either the niRFSG Initialize VI or the niRFSG Initialize With Options VI.
	name specifies the name used to store the waveform. This string is case-insensitive and alphanumeric, and it does not use reserved words.
	size in samples specifies the size of the waveform to allocate in samples.
	error in accepts error information from previously called VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. status is either TRUE (X) for an error, or FALSE (?) for no error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. source describes the origin of the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
	instrument handle out passes a reference to your instrument session to the next VI. instrument handle out is obtained from the niRFSG Initialize VI or the niRFSG Initialize With Options VI and identifies a particular instrument session.
	error out passes error or warning information out of a VI to be used by other VIs. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. status is either TRUE (X) for an error, or FALSE (?) for no error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. code identifies the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed. source describes the origin of the error or warning. The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

Details

If direct download is enabled, NI-RFSG reserves the appropriate amount of memory on the device for the specified waveform. If direct download is disabled, NI-RFSG allocates space in the host memory to hold the requested number of samples.

The niRFSG Write Arb Waveform VI returns an error if you write more data than the amount of memory allocated for it. If you do not write the entire allocation, the signal generator generates uninitialized data during the unwritten portions of the waveform. If you allocate a waveform prior to writing it, NI-RFSG ignores the more data pending? parameter in the niRFSG Write Arb Waveform VI.

Note  Direct download is always enabled on the NI 5672.