Information

PicoLog 1000 Series Programmer's Guide 11

3.3.5

pl1000GetValues

PICO_STATUS pl1000GetValues(

short handle,

unsigned short * values,

unsigned long * noOfValues,

unsigned short * overflow,

unsigned long * triggerIndex

)

This function is used to get values after calling pl1000_run .

Arguments:

handle: handle returned from pl1000OpenUnit or

pl1000OpenUnitProgress

values: an array of sample values returned by the function. The

size of this buffer must be the number of enabled channels multiplied

by the number of samples to be collected.

noOfValues: on entry, the number of sample values per channel

that the function should collect. On exit, the number of samples per

channel that were actually written to the buffer.

overflow: on exit, a bit field indicating which, if any, input channels

overflowed the input range of the device. A bit set to 1 indicates an

overflow. The least significant bit corresponds to channel 1. May be

NULL if an overflow warning is not required.

triggerIndex: on exit, a number indicating when the trigger event

occurred. The number is a zero-based index to the values array, or

0xFFFFFFFF if the information is not available. On entry, the pointer

may be NULL if a trigger index is not required.

Returns:

PICO_OK

PICO_INVALID_HANDLE

PICO_NO_SAMPLES_AVAILABLE

PICO_DEVICE_SAMPLING

PICO_NULL_PARAMETER

PICO_INVALID_PARAMETER

PICO_TOO_MANY_SAMPLES

PICO_DATA_NOT_AVAILABLE

PICO_INVALID_CALL

PICO_NOT_RESPONDING

PICO_MEMORY