From 11:00 PM CST Friday, Apr 11th - 1:30 PM CST Saturday, Apr 12th, ni.com will undergo system upgrades that may result in temporary service interruption.

We appreciate your patience as we improve our online experience.

LabWindows/CVI

Content Type
Programming Language
Current manual

TDMS_SetChannelProperty

TDMS_SetChannelProperty

int TDMS_SetChannelProperty (TDMSChannelHandle channel, const char *property, TDMSDataType dataType, ...);

Purpose

Sets the value of a channel property. If the property does not exist, this function creates it.

Parameters

Input
Name Type Description
channel TDMSChannelHandle The channel handle.
property const char * The name of the channel property. You can specify a built-in property, virtual property, or a property created by TDMS_SetChannelProperty. Virtual properties are special properties that are not saved in the .tdms file, but they can be used to perform certain actions.

The following built-in properties are available:

Property Constant Data Type
Name TDMS_CHANNEL_NAME String (char *)
Description TDMS_CHANNEL_DESCRIPTION String (char *)
Unit String TDMS_CHANNEL_UNIT_STRING String (char *)


The following virtual properties are available:

Property Constant Data Type Description
NI_MinimumBufferSize TDMS_NI_MINIMUM_BUFFER_SIZE unsigned int Use this property to reduce the size of a .tdms file by controlling the number of times the data is written to disk.
dataType TDMSDataType The data type of the property.

If the data type of the property is TDMS_Timestamp, you must use the CVIAbsoluteTime type when you set or get the value of that property. Refer to the Absolute Time functions in the Utility Library for more information about this data type.
value ... The value of the property.

If the data type of the specified property is TDMS_Timestamp, you must pass a value of type CVIAbsoluteTime. Refer to the Absolute Time functions in the Utility Library for more information about this type.

Return Value

Name Type Description
status int Return value indicating whether the function was successful. Unless otherwise stated, zero represents successful execution and a negative number represents the error code.

Error codes are defined in cvi\include\cvitdms.h.

Additional Information

Library: TDM Streaming Library

Include file: cvitdms.h

LabWindows/CVI compatibility: LabWindows/CVI 8.1 and later

© 2016 National Instruments. All rights reserved.

Was this information helpful?

Help us improve your future ni.com experience.

Did you find the documentation you were looking for?

Submit