Purpose

Gets information on the DoIP entity power state.

Format 

        long ndDoIPGetDiagPowerMode(
       TD1 *diagRef,
       unsigned char *powerMode,
       LVBoolean *ok);

Input

diagRef

Specifies the handle for the diagnostic session, obtained from ndOpenDiagnosticOnIPStack and passed to subsequent diagnostic functions. Normally, it is not necessary to manually manipulate the elements of this struct. Output

powerMode

Identifies whether the vehicle is in Diagnostic Power Mode and ready to perform reliable diagnostics. Possible values are:

0 Not ready
1 Ready

All other values are reserved.

ok

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.

Description

ndDoIPGetDiagPowerMode retrieves a vehicle's Diagnostic Power Mode. For example, test equipment can use this information to verify whether the vehicle is in Diagnostic Power Mode, which allows for performing reliable diagnostics on the vehicle's components.