IviPwrMeter_ConfigureRange

CVI/LabWindows IVI Class Driver

IviPwrMeter_ConfigureRange

IviPwrMeterManualRange Capability Group

C Function Prototype

ViStatus IviPwrMeter_ConfigureRange (ViSession vi, ViConstString channelName, ViReal64 rangeLower, ViReal64 rangeUpper);

Purpose

This function configures lower and upper range values for a given channel.

Parameters

Name Type Description
vi ViSession The ViSession handle that you obtain from the IviPwrMeter_init or IviPwrMeter_InitWithOptions function. The handle identifies a particular instrument session.

Default Value: None

channelName ViConstString The name of the channel to configure.

Pass the virtual channel name that you assign to the instrument in the Configuration Utility.

Virtual channel names are aliases for instrument-specific channel strings. The instrument-specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument-specific channel through the Configuration Utility. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument-specific channel names.

Default Value: ""

Notes: You can specify the channel name as a string variable or as a literal enclosed in double quotes.

rangeLower ViReal64 Specify the lower limit of the expected value of the measurement. The driver sets the IVIPWRMETER_ATTR_RANGE_LOWER
attribute to this value.

Unit: Watt

Default Value: 1.0e-6 (W)

rangeUpper ViReal64 Specify the upper limit of the expected value of the measurement. The driver sets the IVIPWRMETER_ATTR_RANGE_UPPER
attribute to this value.

Unit: Watt

Default Value: 0.01 (W)

Return Values