mcCharacteristicWriteRaw
- Updated2023-02-21
- 1 minute(s) read
Purpose
Downloads raw data (no scaling) to a Characteristic for a selected ECU.
Format
| mcTypeStatus | mcCharacteristicWriteRaw(
|
Input
ECURefNum
ECURefNum is the task reference which links to the selected ECU. This reference is originally returned from mcECUSelectEx.
CharacteristicName
CharacteristicName is the name of the Characteristic defined in the A2L database file.
Values
Values contains a pointer to an unsigned 64-bit integer, an unsigned 64-bit integer 1D, or 2D array which is sent to the ECU.
NumberOfValues
Specifies the number of values to write for the task.
Output
Return Value
The return value indicates the status of the function call as a signed 32-bit integer. Zero means the function executed successfully. A negative value specifies an error, which means the function did not perform the expected behavior. A positive value specifies a warning, which means the function performed as expected, but a condition arose that may require attention.
Use the mcStatusToString function of the ECU M&C API to obtain a descriptive string for the return value.
Description
mcCharacteristicWriteRaw writes the raw value(s) of a named Characteristic to an ECU identified by the ECU reference handle ECURefNum.