Main Content

TransferStatus

Status of whether asynchronous read or write operation is in progress

Description

TransferStatus can be idle, read, write, or read&write. If TransferStatus is idle, then no asynchronous read or write operations are in progress. If TransferStatus is read, then an asynchronous read operation is in progress. If TransferStatus is write, then an asynchronous write operation is in progress. If TransferStatus is read&write, then both an asynchronous read and an asynchronous write operation are in progress.

You can write data asynchronously using the fprintf or fwrite functions. You can read data asynchronously using the readasync function, or by configuring ReadAsyncMode to continuous (serial, TCPIP, UDP, and VISA-serial objects only). For detailed information about asynchronous read and write operations, refer to Communicating with Your Instrument.

While readasync is executing for any instrument object, TransferStatus might indicate that data is being read even though data is not filling the input buffer. However, if ReadAsyncMode is continuous, TransferStatus indicates that data is being read only when data is actually filling the input buffer.

Characteristics

Usage

Any instrument object

Read only

Always

Data type

Character vector

Values

Default value is enclosed in braces ({}).

{idle}

No asynchronous operations are in progress.

read

An asynchronous read operation is in progress.

write

An asynchronous write operation is in progress.

read&write

Asynchronous read and write operations are in progress.

See Also

Properties

ReadAsyncMode