ReceiveSetup

NI-488.2

ReceiveSetup


Purpose

Address a device to be a Talker and the interface to be a Listener in preparation for RcvRespMsg.

Format

C

void ReceiveSetup (int boardID, Addr4882_t address)

Visual Basic

CALL ReceiveSetup (boardID%, address%)

Interactive Control (Usage Notes)

ReceiveSetup address

Input

boardID The interface number
address Address of a device to be talk addressed

Description

ReceiveSetup makes the device described by address talk-active, and makes the interface listen-active. This call is usually followed by a call to RcvRespMsg to transfer data from the device to the interface. This call is particularly useful to make multiple calls to RcvRspMsg; it eliminates the need to readdress the device to receive every block of data.

Possible Errors

EARG The address parameter is invalid.
EBUS No devices are connected to the GPIB.
ECIC The interface is not the Controller-In-Charge; see SendIFC.
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.