Measurement Computing Personal488 rev.3.0 - Manual (Page 90)

Personal488 for Windows 95/98/Me/NT/2000 04-10-01 API Reference 6-22
Hello
Syntax INT WINAPI Hello(DevHandleT devHandle, LPSTR message);
devHandle refers to either an IEEE 488 interface or an external device. If devHandle
refers to an external device, the Hello command acts on the hardware interface to
which the external device is attached.
message is a character pointer that contains the returned message, which is the version of
the Dynamic Link Library (DLL) and the version of the device driver.
Returns -1 if error
otherwise, the length in bytes of the message string. The returned byte count will never
exceed 247 bytes.
Bus States None
Example char message[247];
result = Hello(ieee,message);
printf(“%s\n”,message);
See Also Status, OpenName, GetError
The Hello command is used to verify communication with Driver488, and to read the software revision
number. If a non-null string pointer is passed, Hello fills in up to 247 bytes in the string. The application
must ensure that sufficient space is available. When the command is sent, Driver488 returns a string
similar to the following:
Driver488 Revision X.X (C)199X ...
where X is the appropriate revision or year number.