USER_WRITE_POINT_QUALITY

Writes point quality data to the specified device.

You can find the template for this subroutine in:

usrtm_wrtpqual.c

Syntax

void user_write_point_quality(device_struct, address_struct,

        pqualdata, comm_status, status)

DEVICE_DATA *device_struct;

ADDR_DATA *address_struct;

TOOLKIT_QUALDATA *pqualdata;

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>.

address_struct

Is a pointer to the address from which the data was read. ADDR_DATA is a typedef to a structure defined in <inc_path/toolkit.h>.

pqualdata

Is the pointer to the quality data to be written. TOOLKIT_QUALDATA is a typedef to a structure defined in <inc_path/toolkit.h>.

Output Parameters

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_WRITE_FAILED

Could not send command or data to device.

TOOLKIT_TIMEOUT

Sent command or data to device, timed-out waiting for a response.

TOOLKIT_FAILURE

Failure is due to communications failure.

status

Indicates whether the function read all the data. Valid values are:

TOOLKIT_SUCCESS

Function completed successfully.

TOOLKIT_REPLY_LATER

Write request queued for future processing.

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.

More information

Device Communications toolkit subroutines.