IviRFSigGen_GetDigitalModulationBaseStandardName

CVI/LabWindows IVI Class Driver

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.

Return Values