43.3.4.2 Clear Flags

Purpose

This service can be used to clear parameter structure flags.

How to Use the Service

Description

This service clears CarryOut, CarryIn, Zero and Violation flags in the Specific bit field. The Gf2n flag is untouched.

The service name for this operation is ClearFlags.

Parameters Definition

It is possible to directly address this service through the PUKCL_ClearFlags() macro.

Table 43-7. Clear Flags Service Parameters
ParameterTypeDirectionLocationData LengthBefore Executing the ServiceAfter Executing the Service
Specific/CarryOutBitOCleared
Specific/CarryInBitOCleared
Specific/ZeroBitOCleared
Specific/ViolationBitOCleared

Code Example

PUKCL_PARAM PUKCLParam;
PPUKCL_PARAM pvPUKCLParam = &PUKCLParam;

// vPUKCL_Process() is a macro command, which populates the service name
// and then calls the library...
vPUKCL_Process(ClearFlags,pvPUKCLParam); 
if (PUKCL(u2Status) == PUKCL_OK)
            {
            // Success   
            }
else // Manage the error

Status Returned Values

Table 43-8. ClearFlags Service Return Codes
Returned StatusImportanceMeaning
PUKCL_OKService functioned correctly.