National Instruments 372139B-01 Automobile User Manual


 
Chapter 6 Automotive Diagnostic Command Set API for C
Automotive Diagnostic Command Set User Manual 6-36 ni.com
KWP2000 Services
ndClearDiagnosticInformation
Purpose
Executes the ClearDiagnosticInformation service. Clears selected Diagnostic Trouble Codes
(DTCs).
Format
long ndClearDiagnosticInformation(
TD1 *diagRef,
unsigned short groupOfDTC,
LVBoolean *success);
Input
diagRef
Specifies the diagnostic session handle, obtained from ndOpenDiagnostic and passed
to subsequent diagnostic functions. Normally, it is not necessary to manually manipulate
the elements of this struct.
groupOfDTC
Specifies the group of diagnostic trouble codes to be cleared. The following values have
a special meaning:
0x0000 All powertrain DTCs
0x4000 All chassis DTCs
0x8000 All body DTCs
0xC000 All network related DTCs
0xFF00 All DTCs
Output
success
Indicates successful receipt of a positive response message for this diagnostic service.
Return Value
The return value indicates the function call status 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
ndStatusToString function to obtain a descriptive string for the return value.