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. |