IviRFSigGen_GetAnalogModulationSourceName
IviRFSigGenAnalogModulationSource Capability Group
C Function Prototype
ViStatus IviRFSigGen_GetAnalogModulationSourceName (ViSession vi, ViInt32 index, ViInt32 nameBufferSize, ViChar[] name);
Purpose
This function returns the specific driver defined analog modulation source name that corresponds to the one-based index specified by the Index parameter. If you pass in a value for the Index parameter that is less than one or greater than the value of the IVIRFSIGGEN_ATTR_ANALOG_MODULATION_SOURCE_COUNT attribute, the function returns an empty string in the Name parameter and returns the Invalid Value error.
Note: For an instrument with only one analog modulation source, i.e. the IVIRFSIGGEN_ATTR_ANALOG_MODULATION_SOURCE_COUNT attribute is one, the driver may return an empty string.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | The ViSession handle that you obtain from the IviRFSigGen_init or IviRFSigGen_InitWithOptions function. The handle identifies a particular instrument session. Default Value: None |
| index | ViInt32 | The index of the analog modulation source whose name is returned. The value must be greater than or equal to one and less than or equal to IVIRFSIGGEN_ATTR_ANALOG_MODULATION_SOURCE_COUNT. Note: Zero is not a legal value. Default Value: 1 |
| nameBufferSize | ViInt32 | Specify the buffer size for the Name parameter.
Default Value: 0 |
| name | ViChar[] | The analog modulation source name that corresponds to the Index.
The Name buffer must contain at least as many elements as the value you specify with the Name Buffer Size parameter. |