Skip to content

NI DCPOWER Inherent Ivi Attributes

Jump to bottom
ni-siray edited this page May 7, 2021 · 5 revisions

Inherent Ivi Attributes

NIDCPOWER_ATTRIBUTE_RANGE_CHECK

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050002 ViBoolean R/W Session None niDCPower_InitializeWithIndependentChannels

Description

Specifies whether to validate attribute values and function parameters.

If this attribute is enabled, NI-DCPower validates the parameter values that you pass to NI-DCPower functions. Range checking parameters is useful for debugging. After you validate your program, you can set this attribute to VI_FALSE to disable range checking and maximize performance.

Use the niDCPower_InitializeWithIndependentChannels function to override the default value.

Default Value: VI_TRUE.

NIDCPOWER_ATTRIBUTE_QUERY_INSTRUMENT_STATUS

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050003 ViBoolean R/W Session None None

Description

Specifies whether NI-DCPower queries the instrument status after each operation.

Querying the instrument status is useful for debugging. After you validate your program, you can set this attribute to VI_FALSE to disable status checking and maximize performance.

NI-DCPower ignores status checking for particular attributes regardless of the setting of this attribute.

Use the niDCPower_InitializeWithIndependentChannels function to override this value.

Default Value: VI_TRUE

NIDCPOWER_ATTRIBUTE_CACHE

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050004 ViBoolean R/W Session None niDCPower_InitializeWithChannels

Description

Specifies whether to cache the value of attributes.

When caching is enabled, NI-DCPower records the current instrument settings and avoids sending redundant commands to the instrument. Enabling caching can significantly increase execution speed.

NI-DCPower might always cache or never cache particular attributes regardless of the setting of this attribute.

Use the niDCPower_InitializeWithIndependentChannels function to override this value.

Default Value: VI_TRUE

NIDCPOWER_ATTRIBUTE_SIMULATE

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050005 ViBoolean R/W Session None niDCPower_InitializeWithIndependentChannels

Description

Specifies whether to simulate NI-DCPower I/O operations. VI_TRUE specifies that operation is simulated.

Defined Values:

VI_FALSE (0) Do not simulate NI-DCPower I/O operations.
VI_TRUE (1) Simulate NI-DCPower I/O operations.

Default Value: VI_FALSE

NIDCPOWER_ATTRIBUTE_RECORD_COERCIONS

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050006 ViBoolean R/W Session None None

Description

Specifies whether the IVI engine records the value coercions it makes for ViInt32 and ViReal64 attributes. Call the niDCPower_GetNextCoercionRecord function to read and delete the earliest coercion record from the list.

Default Value: The default value is VI_FALSE. Use the niDCPower_InitializeWithIndependentChannels function to override this value.

NIDCPOWER_ATTRIBUTE_INTERCHANGE_CHECK

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050021 ViBoolean R/W Session None niDCPower_InitializeWithIndependentChannels

Description

Specifies whether to perform interchangeability checking and log interchangeability warnings when you call NI-DCPower functions. VI_TRUE specifies that interchangeability checking is enabled.

Interchangeability warnings indicate that using your application with a different instrument might cause different behavior. Call the niDCPower_GetNextInterchangeWarning function to retrieve interchange warnings.

Call the niDCPower_GetNextInterchangeWarning function to clear the list of interchangeability warnings without reading them.

Interchangeability checking examines the attributes in a capability group only if you specify a value for at least one attribute within that group. Interchangeability warnings can occur when an attribute affects the behavior of the instrument and you have not set that attribute or when the attribute has been invalidated since you set it.

Default Value: VI_FALSE

NIDCPOWER_ATTRIBUTE_SPECIFIC_DRIVER_DESCRIPTION

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050514 ViString RO Session None None

Description

Contains a brief description of the specific driver.

NIDCPOWER_ATTRIBUTE_SPECIFIC_DRIVER_PREFIX

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050302 ViString RO Session None None

Description

Contains the prefix for NI-DCPower. The name of each user-callable function in NI-DCPower begins with this prefix.

NIDCPOWER_ATTRIBUTE_SPECIFIC_DRIVER_VENDOR

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050513 ViString RO Session None None

Description

Contains the name of the vendor that supplies NI-DCPower.

NIDCPOWER_ATTRIBUTE_SPECIFIC_DRIVER_REVISION

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050551 ViString RO Session None None

Description

Contains additional version information about NI-DCPower.

NIDCPOWER_ATTRIBUTE_SPECIFIC_DRIVER_CLASS_SPEC_MAJOR_VERSION

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050515 ViInt32 RO Session None None

Description

Contains the major version number of the class specification with which NI-DCPower is compliant.

NIDCPOWER_ATTRIBUTE_SPECIFIC_DRIVER_CLASS_SPEC_MINOR_VERSION

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050516 ViInt32 RO Session None None

Description

Contains the minor version number of the class specification with which NI-DCPower is compliant.

NIDCPOWER_ATTRIBUTE_SUPPORTED_INSTRUMENT_MODELS

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050327 ViString RO Session None None

Description

Contains a comma-separated (,) list of supported NI-DCPower instrument models.

NIDCPOWER_ATTRIBUTE_GROUP_CAPABILITIES

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050401 ViString RO Session None None

Description

Contains a comma-separated list of class-extension groups that NI-DCPower implements.

NIDCPOWER_ATTRIBUTE_CHANNEL_COUNT

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050203 ViInt32 RO Session None None

Description

Indicates the number of channels in the session. For channel-based attributes, the IVI engine maintains a separate cache value for each channel.

NIDCPOWER_ATTRIBUTE_INSTRUMENT_MANUFACTURER

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050511 ViString RO Instrument None None

Description

Contains the name of the manufacturer for the instrument you are currently using.

Note  To specify an instrument name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTRIBUTE_INSTRUMENT_MODEL

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050512 ViString RO Instrument None None

Description

Contains the model number or name of the instrument that you are currently using.

Note  To specify an instrument name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTRIBUTE_INSTRUMENT_FIRMWARE_REVISION

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050510 ViString RO Instrument None niDCPower_revision_query

Description

Contains the firmware revision information for the device you are currently using.

Note  To specify an instrument name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTRIBUTE_SERIAL_NUMBER

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1150152 ViString RO Instrument None niDCPower_revision_query

Description

Contains the serial number for the instrument you are currently using.

Note  To specify an instrument name when accessing this attribute, you must first initialize the session using the niDCPower_InitializeWithIndependentChannels function

NIDCPOWER_ATTRIBUTE_DRIVER_SETUP

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050007 ViString RO Session None niDCPower_InitializeWithIndependentChannels

Description

Indicates the Driver Setup string that you specified when initializing the driver.

Some cases exist where you must specify the instrument driver options at initialization time. An example of this case is specifying a particular device model from among a family of devices that the driver supports. This attribute is useful when simulating a device. You can specify the driver-specific options through the DriverSetup keyword in the optionsString parameter in the niDCPower_InitializeWithIndependentChannels function or through the IVI Configuration Utility.

If you do not specify a Driver Setup string, this attribute returns an empty string.

NIDCPOWER_ATTRIBUTE_LOGICAL_NAME

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050305 ViString RO Session None None

Description

Contains the logical name(s) you specified when opening the current IVI session.

Note  IVI logical names are not supported in sessions created using the niDCPower_InitializeWithIndependentChannels function

You can pass a logical name to a deprecated initialize function. The IVI Configuration utility must contain an entry for the logical name. The logical name entry refers to a function section in the IVI Configuration file. The function section specifies a physical instrument and initial user options.

NIDCPOWER_ATTRIBUTE_IO_RESOURCE_DESCRIPTOR

Specific Attribute

Numeric Value Data
type		 Access Applies to Coercion High-Level Functions
1050304 ViString RO Session None None

Description

Indicates the resource descriptor NI-DCPower uses to identify the resource(s) used by the NI-DCPower session.

The resource name specified with the niDCPower_InitializeWithIndependentChannels function can include instrument(s) and/or channel(s) but does not support logical names.

If you initialize NI-DCPower with a logical name using a deprecated initialize VI, this attribute contains the resource descriptor that corresponds to the entry in the IVI Configuration utility.

If you initialize NI-DCPower with the resource descriptor, this attribute contains that value.

Table of Contents

Home

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally