RcvRespMsg

---

Purpose

Read data bytes from a device that is already addressed to talk.

Format

C

void RcvRespMsg (int boardID, void *buffer, size_t count, int termination)

Visual Basic

CALL RcvRespMsg (boardID%, buffer$, termination%)

Interactive Control (Usage Notes)

RcvRespMsg count termination

Input

boardID	The interface number
count	Number of bytes read
termination	Description of the data termination mode (STOPend or an 8-bit EOS character)

Output

buffer

Stores the received data bytes

Description

RcvRespMsg reads up to count bytes from the GPIB and places these bytes into buffer. Data bytes are read until either count data bytes have been read or the termination condition is detected. If the termination condition is STOPend, the read is stopped when a byte is received with the EOI line asserted. Otherwise, the read is stopped when the 8-bit EOS character is detected. The actual number of bytes transferred is returned in the global function, Ibcnt.

RcvRespMsg assumes that the interface is already in its listen-active state and a device is already addressed to be a Talker (see ReceiveSetup or Receive).

Possible Errors

EABO	The I/O timeout period elapsed before all the bytes were received.
EADR	The interface is not in the listen-active state; use ReceiveSetup to address the GPIB properly.
EARG	The termination parameter is invalid. It must be either STOPend or an 8-bit EOS character.
EDVR	The NI-488.2 driver is either configured incorrectly or is not properly installed.
EHDL	boardID is out of range.
ELCK	The requested operation could not be performed because of an existing lock by another process.
ENEB	The interface is not installed or is not properly configured.
EOIP	Asynchronous I/O is in progress.