Documentation Center

  • Trials
  • Product Updates

SamplesAcquiredFcn

Specify callback function to execute when predefined number of samples is acquired for each channel group member

Description

    Note:   You cannot use the legacy interface on 64–bit MATLAB®. See Session-Based Interface to acquire and generate data.

A samples acquired event is generated immediately after the number of samples specified by the SamplesAcquiredFcnCount property is acquired for each channel group member. This event executes the callback function specified for SamplesAcquiredFcn.

The samples acquired event is executed regardless of its waiting time in the queue.

Use SamplesAcquiredFcn to trigger an event each time a specified number of samples is acquired. To process samples at regular time intervals, use the TimerFcn property.

Samples acquired event information is not stored in the EventLog property. When the callback function is executed, the second argument is a structure containing two fields. The Type field value is set to the string 'SamplesAcquired', and the Data field values are given below.

Data Field Value

Description

AbsTime

The absolute time (as a clock vector) the event occurred.

RelSample

The acquired sample number when the event occurred.

Characteristics

Usage

AI, common to all channels

Access

Read/write

Data type

String

Read-only when running

No

Values

The default value is an empty string.

Was this topic helpful?