Technical reference
3.3.4 ps2000_get_times_and_values
long ps2000_get_times_and_values( | short | handle, |
| long | * times, |
| short | * buffer_a, |
| short | * buffer_b, |
| short | * buffer_c, |
| short | * buffer_d, |
| short | * overflow, |
| short | time_units, |
| long | no_of_values ) |
11
This function is used to get values and times. It will not return any valid times if the unit is in streaming mode. It is essential for ETS operation.
Arguments | handle, the handle to the required device. |
| times, a pointer to the buffer for the times. Each time is the interval |
| between the trigger event and the corresponding sample. Times |
| before the trigger event are negative, and times after the trigger |
| event are positive. |
| buffer_a, pointer to the buffer that receives data from the |
| oscilloscope. If the pointer is NULL, nothing will be written to it. See |
| Scaling for details of data format. |
| buffer_b, |
| buffer_c, |
| buffer_d, not used |
| overflow. Bit 0 indicates whether an overflow has occurred. |
| time_units, which can be one of the following: |
| PS2000_FS (0) = femtoseconds, |
| PS2000_PS (1) = picoseconds, |
| PS2000_NS (2) = nanoseconds (default), |
| PS2000_US (3) = microseconds, |
| PS2000_MS (4) = milliseconds, or |
| PS3000_S (5) = seconds. |
| no_of_values,the number of data points to return. In streaming |
| mode, this is the maximum number of values to return. |
|
|
Returns | The actual number of data values returned, which may be less than |
| the no_of_values if streaming. |
| 0 is returned if one or more of the parameters are out of range or if |
| the times will overflow with the time_units requested. Use |
| ps2000_get_timebase() in order to acquire the most suitable |
| time_units. |
|
|
Copyright 2006 Pico Technology Limited. All rights reserved. |