Admin Production ni-theme
Current Publication

SubtractCVIAbsoluteTimes

LabWindows/CVI

SubtractCVIAbsoluteTimes

int SubtractCVIAbsoluteTimes (CVIAbsoluteTime absoluteTime1, CVIAbsoluteTime absoluteTime2, CVITimeInterval *result);

Purpose

Subtracts the second absolute time value from the first absolute time value and returns the resulting time interval value.

Time interval values can be negative values.

Parameters

Input
Name Type Description
absoluteTime1 CVIAbsoluteTime Absolute time value in National Instruments Binary Time Format.
absoluteTime2 CVIAbsoluteTime Absolute time value in National Instruments Binary Time Format.
Output
Name Type Description
result CVITimeInterval The result of the calculation, as a time interval value in National Instruments Binary Time Format.

Return Value

Name Type Description
status int The result of the function call. Negative values represent errors.

The following table describes the results that this function returns.

Code Constant Description
0 or positive values Success.
–1 kCVITimeInvalidArgumentError An argument passed to the function is invalid.
–2 kCVITimeNullPointerError A NULL pointer was passed to the function instead of a valid memory address.
–3 kCVITimeOverflowError A numerical calculation resulted in an overflow.
–4 kCVITimeDateOutOfRangeError A time value passed to the function is not in the supported range.
–5 kCVITimeOperationFailedError The operation failed due to an unspecified system error.

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 9.0 and later