pdudcu_ext DEPRECATED
common_value.r8.v = pdudcu(unscaled_value.g.v, pdb.s.r, error.i2.r
[,units_text.i1a.r])
This function is used to scale the raw data associated with a device
to the equivalent common units (eg AMPS, KV, MOHMS). The function
returns a double-precision real value. The input unprocessed data is
scaled based upon one, two, or four byte length as specified by the
IDL bits in the Process Data Block (PDB) which must be supplied in the
"pdb" structure. If requested, the common units text will be
returned in the array "units_text".
unscaled_value unprocessed data to be scaled; length specified by
'idl' bits in the PDB
pdb Process Data Block (reading or setting property)
(structure of type PDB_RS_EXT)
error returned status value
(OK = scaling success
DIO_xxx = scaling failure)
[units_text] returned common units text (LEN_DEV_UNITS characters)
(default is NULL)
This function returns status values as follows:
equivalent value scaled by the common transform
This function requires the following include files:
cnsparam_h, cns_data_structs_h, clib_h, acnet_errors_h
Related functions:
pdudcu, pdudpu, pdudpu_ext, pdpucu, pdpucu_ext, pdpucu8,
pdcupu, pdcupu_ext, pdcupu8, pdcuud, pdcuud8, pcpuud,
pdimax, pdulen, pdb_valid_length_c, pdb_scaling_table_limits_c,
common_transform_num_const_c, is_string_common_transform_c,
is_linear_common_transform_c, is_unscalable_primary_transform_c
C/C++ usage:
char units_text[LEN_DEV_UNITS];
short error;
int unscaled_value;
double common_value;
PDB_RS_EXT pdb;
common_value = pdudcu_ext((void *) &unscaled_value,&pdb,&error,
units_text);