IviRFSigGen_GetDigitalModulationBaseStandardName
IviRFSigGenDigitalModulationBase Capability Group
C Function Prototype
ViStatus IviRFSigGen_GetDigitalModulationBaseStandardName (ViSession vi, ViInt32 index, ViInt32 nameBufferSize, ViChar[] name);
Purpose
This function returns the specific driver defined DigitalModulationBase standard 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_DIGITAL_MODULATION_BASE_STANDARD_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 DigitalModulationBase standard, i.e. the IVIRFSIGGEN_ATTR_DIGITAL_MODULATION_BASE_STANDARD_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 | Specifies the index of the DigitalModulationBase Name to return.
Default Value: 0 |
| nameBufferSize | ViInt32 | Specify the buffer size for the Name parameter.
Default Value: 0 |
| name | ViChar[] | The DigitalModulationBase 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. |