 ReadAduDevice
This function reads data from the ADU Device pipe. The number of bytes read is returned
in lpNumberOfBytesRead.
The handle value must be the value returned by the open call.
Date read is in the form of NULL terminated ASCII strings.
ADU responses are limited to 7 characters for the Low-Speed ADU
interfaces which includes the ADU100, ADU200, ADU208 and ADU218.
Responses from the Full-Speed devices are up to 63 bytes in
length.
Full-Speed ADU devices include the ADU70, ADU71,ADU72,
ADU73, ADU228, ADU258, ADU222 and the ADU252.
C Declaration:
int __stdcall ReadAduDevice(void * hDevice,
const void * lpBuffer,
unsigned long nNumberOfBytesToRead,
unsigned long * lpNumberOfBytesWRead,
unsigned long iTimeout);
Visual Basic Declaration:
Declare Function ReadAduDevice Lib "AduHid.DLL" _
(ByVal aduHandle As Long, ByVal lpBuffer As String, _
ByVal lNumberOfBytesToRead As Long, _
ByRef lBytesRead As Long, ByVal iTimeout As Long) As Long
Arguments:
| Argument |
Type |
Value |
Description |
| hDevice |
void * |
value from open call |
handle to the device |
| lpBuffer |
const char * |
address of buffer |
buffer to receive data |
| nNumberOfBytesToRead |
unsigned long |
> 0 |
number of bytes to read |
| lpNumberOfBytesRead |
unsigned long * |
|
number of bytes read |
| iTimeout |
unsigned long |
|
milli-seconds to wait |
A non-zero iTimeout value can only be supplied if timeout processing was activated during
the open call. (ie. a non-zero iTimeout value was passed into the open function)
Return Codes:
| Value |
Description |
| 0 |
call failed |
| other |
call succeeded |
Note: call GetLastError to get more information about a failed read operation |