QLIB-function: QAPIExtReadString

The function QAPIExtReadString receives a string from a GPIB Device. This instruction also is provided for RS422/485 boards in the future.

ULONG QAPIExtReadString ( ULONG cardhandle, ULONG device, char* buffer, ULONG chars, ULONG reserved );

Parameter 1

cardhandle

This is a previously opened handle for the card. A card can be opened with the command "QAPIExtOpenCard()".

Parameter 2:

device

This parameter holds the talker address of a device on the GPIB Bus.

Parameter 3:

buffer

Destination string. A pointer to a buffer that receives the response from the device.

Parameter 4:

chars

This parameter indicates the size in bytes of the buffer.

Parameter 5:

reserved

Parameter for future use. This parameter should be zero.

Return value
If the function was successful the value 1 is returned and the buffer will hold the response of the device. If the function fails the return value is zero.

Links

Back to the QLIB overview