Kwp2000 services, Ndcleardiagnosticinformation, Kwp2000 services -36 – National Instruments CAN 372139B-01 User Manual

Page 200: Ndcleardiagnosticinformation -36

Advertising
background image

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.

Advertising