mcDAQClear
- Updated2023-02-21
- 1 minute(s) read
mcDAQClear
Purpose
Stops communication for the Measurement task and clears the task.
Format
| mcTypeStatus | mcDAQClear(
|
Input
DAQRefNum
DAQRefNum is the task reference which links to the selected Measurement task. This reference is originally returned from mcDAQInitialize.
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
mcDAQClear must always be the final function called for a Measurement task. If you do not use mcDAQClear, the remaining Measurement task configuration can cause problems in the execution of subsequent applications. Because this function clears the Measurement task, the Measurement task reference is not given as an output but is transferred into an ECU reference task handle. To change properties of a running Measurement task, use mcDAQStartStop to stop the task, mcSetProperty to change the desired DAQ property, then mcDAQStartStop to restart the Measurement task.