Skip to main content
Skip table of contents

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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.