Determines the validity of a diagnostic point.

You can find the template for this subroutine in:

usrtm_valdiagpt.c

Syntax

void user_valid_diag_point(device_struct, address_struct,

                           valid_pt, comm_status, status)

DEVICE_DATA  *device_struct;

ADDR_DATA    *address_struct;

int *valid_pt;

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

Output Parameters

valid_pt

Defines whether the point is valid. Valid values are:

TOOLKIT_SUCCESS	The point is valid
TOOLKIT_FAILURE	The point is not valid

valid_pt is not a Boolean value.

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 read all the data. 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.

More information

Device Communications toolkit subroutines.

---