Configures auto zero for the device.

Syntax

ViStatus _VI_FUNC niDCPower_ConfigureAutoZero(ViSession vi, ViConstString channelName, ViInt32 autoZero)

Remarks

Note

This function is not supported on all devices. Refer to Supported Functions by Device for more information about supported devices.

Refer to the NI PXI-4132 Auto Zero and NI PXI-4132 Measurement Configuration and Timing topics in the NI DC Power Supplies and SMUs Help for more information about how to configure your measurements.

Parameters

NameDirectionTypeDescription
vi[in]ViSession

Identifies a particular instrument session. vi is obtained from the niDCPower_InitializeWithIndependentChannels function.

channelName[in]ViConstString

Specifies the channel(s) to use. Specify the channel(s) using the form PXI1Slot3/0,PXI1Slot3/2-3,PXI1Slot4/2-3 or PXI1Slot3/0,PXI1Slot3/2:3,PXI1Slot4/2:3, where PXI1Slot3 and PXI1Slot4 are instrument resource names and 0, 2, and 3 are channels.

If you pass "" for this control, all channels in the session are used.

autoZero[in]ViInt32

Specifies the auto-zero setting. Refer to the Measurement Configuration and Timing topic and the Auto Zero topic for your device for more information about how to configure your measurements.

Defined Values:

Name

Value

Description

NIDCPOWER_VAL_OFF

0 (0x0)

Disables auto-zero.

NIDCPOWER_VAL_ONCE

1024 (0x400)

Makes zero conversions following the first measurement after initiating the channel(s). Channels use these zero conversions for the preceding measurement and future measurements until they are reinitiated.

NIDCPOWER_VAL_ON

1 (0x1)

Makes zero conversions for every measurement.

Returns

Reports the status of this operation. To obtain a text description of the status code, call niDCPower_error_message. To obtain additional information concerning the error condition, call niDCPower_GetError. The general meaning of the status code is as follows:

Value

Meaning

0

Success

Positive Values

Warnings

Negative Values

Errors