ListAllExtended [LJM User's Guide]
Advanced version of LJM_ListAll that performs an additional query of arbitrary registers on the device.
Syntax
LJM_ERROR_RETURN LJM_ListAllExtended(
int DeviceType,
int ConnectionType,
int NumAddresses,
const int * aAddresses,
const int * aNumRegs,
int MaxNumFound,
int * NumFound,
int * aDeviceTypes,
int * aConnectionTypes,
int * aSerialNumbers,
int * aIPAddresses,
unsigned char * aBytes)
Parameters
DeviceType [in]
Filter device type to find. LJM_dtANY(0) for any T-series device, LJM_dtT4 (4) for T4 series device, LJM_dtT7 (7) for T7 series device, LJM_dtDIGIT (200) for Digit series device.
ConnectionType [in]
Filter connection type to scan. LJM_ctANY (0) for any connection type, LJM_ctUSB (1) for USB, LJM_ctETHERNET (3) for Ethernet, LJM_ctWIFI (4) for WiFi.
NumAddresses [in]
The number of addresses to query. Also the size of aAddresses and aNumRegs.
aAddresses [in]
The addresses to query for each device that is found.
aNumRegs [in]
The addresses to query for each device that is found. Each aNumRegs[i] corresponds to aAddresses[i].
MaxNumFound [in]
The maximum number of devices to find. Also the size of aDeviceTypes, aConnectionTypes, aSerialNumbers, and aIPAddresses.
NumFound [out]
A pointer that returns the number of devices found.
aDeviceTypes [out]
An array of device types, one for each of the NumFound devices. Must be preallocated to size MaxNumFound.
aConnectionTypes [out]
An array of connection types, one for each of the NumFound devices. Must be preallocated to size MaxNumFound.
aSerialNumbers [out]
An array of serial numbers, one for each of the NumFound devices. Must be preallocated to size MaxNumFound.
aIPAddresses [out]
An array of IP Addresses, one for each (if applicable) of the NumFound devices. When the device is not TCP capable, IP address will be LJM_NO_IP_ADDRESS.
aBytes [out]
An array that must be preallocated to size:
MaxNumFound * <the sum of aNumRegs> * LJM_BYTES_PER_REGISTER,
which will contain the query bytes sequentially. A device
represented by index i would have an aBytes index of:
i * <the sum of aNumRegs> * LJM_BYTES_PER_REGISTER
Returns
LJM errorcodes or 0 for no error.
Remarks
When the ConnectionType parameter of this function is network-based, this function will check the IP addresses listed in LJM_SPECIAL_ADDRESSES_FILE.
Examples
See examples/utilities/list_all_extended.c available in the LJM C++ examples.