Ndreadecuidentification, Ndreadecuidentification -51 – National Instruments CAN 372139B-01 User Manual

Page 215

Advertising
background image

Chapter 6

Automotive Diagnostic Command Set API for C

© National Instruments Corporation

6-51

Automotive Diagnostic Command Set User Manual

ndReadECUIdentification

Purpose

Executes the ReadECUIdentification service. Returns ECU identification data.

Format

long ndReadECUIdentification(

TD1 *diagRef,

unsigned char mode,

unsigned char dataOut[],

long *len,

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.

mode

Indicates the type of identification information to be returned. The values are application
specific.

Output

dataOut

Returns the ECU identification data.

len

On input,

len

must contain the

dataOut

array length. On return, it contains the number

of valid data bytes in the

dataOut

array.

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