TDMS Reserve File Size Function

FlexRIO Help

Edition Date: November 2015

Part Number: 372614J-01

»View Product Info

»Download the Help in ZIP Format

Owning Palette: Advanced TDMS VIs and Functions

Requires: Base Development System (Windows)

Copyright: (c) 2015 National Instruments. All rights reserved.

Pre-allocates disk space for writing and prevents fragmentation on a file-system level. If you are running this function on Windows with User Account Control enabled, you must run LabVIEW or the application with administrator privileges to avoid a run-time error.

If you are using this function to build an application, National Instruments recommends that you embed an application manifest to the application. The requested execution level in the manifest file must be requireAdministrator.

When a .tdms file is in use by this function, no other processes can access this file.

Example

append? specifies whether to append the new size that this function reserves to an existing file. If the value is FALSE, this function changes the file size of tdms file to the reserved size. If the value is TRUE, this function extends the file size of tdms file with the reserved size. The default is TRUE.
tdms file specifies a reference number to the .tdms file on which to perform the operation. Use the TDMS Advanced Open function to open the refnum.
reserve size specifies the size to reserve in samples.

You can calculate the actual size, in bytes, that this function reserves by multiplying the value of reserve size by the number of bytes of data type. For example, if the value of reserve size is 512 and data type is an unsigned 16-bit integer, then you can calculate the actual size that this function reserves as follows: 512×(16÷8) = 1024 bytes.
Note  If the disable buffering? input of the TDMS Advanced Open function is TRUE, the actual reserved size in bytes must be a multiple of the sector size of the hard disk. Use the TDMS Advanced Open function to obtain the sector size of the hard disk.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
data type specifies the type of data on which you want to perform the operation. This input accepts integers, floating-point numbers, Booleans, and timestamps.
Note  You can wire the following floating-point numbers to this input:
  • Single-precision and double-precision floating-point numbers
  • Complex single-precision and double-precision floating-point numbers
  • Extended-precision floating-point numbers
tdms file out returns a TDMS file reference to the .tdms file on which you performed the operation.
error out contains error information. This output provides standard error out functionality.

Example

Refer to the TDMS Advanced Append Multiple Headers VI in the labview\examples\File IO\TDMS\Advanced Read and Write\Asynchronous Read and Write directory for an example of using the TDMS Reserve File Size function.

WAS THIS ARTICLE HELPFUL?

Not Helpful