Download SL1000 Control API User`s Manual - Electro

3.14 Acquisition and Deletion of Measured Data
Get Waveform Data Segment
int SxGetAcqDataEx( SX_HNDL_CH | SX_HNDL_MEASGRP hAny, int acqNo, int start, int count,
void* buf, int blen, int *rlen );
int SxGetAcqDataExL( SX_HNDL_CH | SX_HNDL_MEASGRP hAny, __int64 acqNo, __int64 start,
int count, void* buf, int blen, int *rlen );
int SxGetAcqDataExD( SX_HNDL_CH | SX_HNDL_MEASGRP hAny, double acqNo, double start,
int count, void* buf, int blen, int *rlen );
ERR GetAcqDataEx( HNDL hAny, long acqNo, long start, int count, ref any[] buf, int blen, ref int
rlen );
ERR GetAcqDataEx( HNDL hAny, long acqNo, long start, int count, ref any[] buf, ref int rlen );
Description
Stores the waveform data with the acquisition number specified by acqNo to the memory
location specified by buf. The values stored in buf are A/D converted values. To convert
the data into physical values, the vResolution and vOffset acquisition data information
values are necessary.
If the waveform data from multiple channels is stored, the data will be stored in block
format starting with the lowest numbered channel’s data.
Specify the beginning of the waveform data segment that you want to retrieve using the
start parameter. Specify the value using the sampling units of measuring group 1.
Specify the amount waveform data that you want to retrieve using the count parameter.
Specify the value using the sampling units of measuring group 1. If you specify 0 for
count, all of the data from the beginning of the segment to the end of the waveform data
will be retrieved.
Use blen to specify the size in bytes of buf. The actual stored byte size will be stored in
rlen.
If hAny is a channel handle, only the waveform data for that channel will be stored.
If hAny is a measuring group, the waveform data of all of the channels in the measuring
group will be stored.
If the number of acquisitions and measurement points exceeds 2,147,483,647, use
SxGetAcqDataExL() or SxGetAcqDataExD(). SxGetAcqDataExL() cannot be used in
VB6.
Parameters
hAny
acqNo
Any kind of handle
An acquisition number
Positive number: An absolute acquisition number
Negative number:A relative number with –1 being the most recent
acquisition.
Zero:All of the history (in Triggered mode)
The latch interval (in Free Run mode)
startThe start of the data segment to be retrieved (in the sampling units of
measuring group 1, starting from 0)
countThe length of the data segment to be retrieved (in the sampling units of
measuring group 1, starting from 0)
buf
Where to store the waveform data
blen
The size of the memory area where the waveform data is stored (in bytes)
rlen
Where to store the size of the stored waveform data
Return Value
Returns zero if the function succeeds and a nonzero error code if the function does not
succeed.
3-48
IM 720320-01E