cbLogGetSampleInfo()

Returns the sample interval, sample count, and the date and time of the first data point contained in a binary file.

Function Prototype

Visual Basic

Function cbLogGetSampleInfo(ByVal Filename$, ByRef SampleInterval&, ByRef SampleCount&, ByRef StartDate&, ByRef StartTime&) As Long

C/C++

int cbLogGetSampleInfo(char* Filename, int* SampleInterval, int* SampleCount, int* StartDate, int* StartTime)

Arguments

Filename

The name of the file to retrieve sample information from.

SampleInterval

The time interval, in seconds, between samples.

SampleCount

The number of samples contained in the file.

StartDate

The date when the first data point was logged in the file. Date values are packed in the following format:

Byte 0: day

Byte 1: month

Byte 2 - 3: year

StartTime

The time when the first data point was logged in the file. Time values are packed in the following format:

Byte 0: seconds

Byte 1: minutes

Byte 2: hours

Byte 3: 0xff = 24hour format; 0x0 = AM; 0x1 = PM

Returns

• Error code or 0 if no errors
• SampleInterval – Returns the time interval, in seconds, between samples.
• SampleCount – Returns the number of samples in the file.
• StartDate – Returns the date when the first data point was logged in the file.
• StartTime – Returns the time when the first data point was logged in the file.

Notes

• Time stamped data is returned according to the TimeZone and TimeFormat preferences. Refer to cbLogSetPreferences().