USER_DEVICE_INFO

Defines the device-specific characteristics for the accessible memory on the device.

Accessible memory sharing the same characteristics, and which can be read contiguously, is typically grouped together to form a domain. Elements within a domain must be readable/writable by a single request to read or write via user_read_data() and user_write_data().

You can find the template for this subroutine in:

usrtm_dvin.c

Syntax

void user_device_info(device_struct, num_domains,

        domain, supported, comm_status, status)

DEVICE_DATA *device_struct;

int *num_domains;

DOMAIN_ARRAY *domain;

SUPPORT *supported;

int *comm_status;

int *status;

Input Parameters

device_struct

Is a pointer to the structure defining device data. DEVICE_DATA is a typedef to a structure defined in <inc_path/toolkit.h>.

Output Parameters

num_domains

Is the number of domains defined for the device.

domains

Is a pointer to an array of domain structures which define the characteristics of each group of memory locations.

There are TOOLKIT_MAX_NUM_DOMAIN elements in the structure. The first domain element is domain[0], and all elements through domain[*num_domains - 1] should contain valid data.

DOMAIN_ARRAY is a typedef to a structure defined in <inc_path/toolkit.h>.

supported

Is a pointer to a structure defining the supported options for the device. SUPPORT is a typedef to a structure defined in <inc_path/toolkit.h>.

comm_status

Indicates whether a status of TOOLKIT_FAILURE occurred as a result of a communication failure. Valid values are:

TOOLKIT_SUCCESS

Failure is not due to communications failure.

TOOLKIT_FAILURE

Failure is due to communications failure.

status

Indicates whether the function successfully obtained all of the requested information. Valid values are:

TOOLKIT_SUCCESS

Function completed successfully.

TOOLKIT_FAILURE

Function did not complete successfully. Check comm_status to see if the failure was the result of a communication failure.

Return Value

None.

Programming Note

The default value for each option is the value set in user_protocol_info(). A field whose value is TOOLKIT_NO cannot be reset to TOOLKIT_YES in this function. If the value for a return by user_protocol_info() is TOOLKIT_NO and it is reset to TOOLKIT_YES in this function, the new value is ignored.

More information

Device Communications toolkit subroutines.