QLIB-function: QAPIReadString


With the function QAPIReadString a string is received by a set. This instruction is used for the QUANCOM GPIB controllers in the current socket of the QLIB. This instruction also is provided for RS422/485 boards in the future.

ULONG QAPIReadString ( ULONG cardid, ULONG device, char* buffer, ULONG chars, ULONG reserved );


Parameter 1
cardid
Defines the ID of the card , from which you can get an information

Parameter 2:
device
The set indicates on the bus. This is the talker-address of the sending set on the GPIB bus.

Parameter 3:
buffer
This one shall pointer contain the string to be received on the writing buffer.

Parameter 4:
chars
The size memory which is available for the reception of data provided by Buffer.

Parameter 5:
reserved
Parameter for future extensions. This parameter shall be put on ZERO.

Return value
If the function was executed successfully, then the value 1 is delivered. The response of the set is in memory blocks submitted by buffer to it. If the function is failed, then the return value is always 0L.

Links
 QAPIWriteString, QAPIReadString, QAPIExtWriteString, QAPIExtReadString
 Back to the QLIB overview