SNIP_CLASSIC_DLT_SECTION_7_1_3_2_Generating_hook_functions

7.1.3.2 Generating hook functions [SWS_Dlt_00285] Upstream requirements: RS_LT_00009 ⌈Because the interface Dlt_SendTraceMessage is a SW-C interface, an internal function which is equivalent to Dlt_SendTraceMessage, shall be implemented to be called by the generated hook functions.⌋ [SWS_Dlt_00277] Upstream requirements: RS_LT_00009 ⌈In the hook function the internal representation of Dlt_SendTraceMessage shall be called. This call shall be in non-verbose mode.⌋ [SWS_Dlt_00278] ⌈The payload for this hook function call shall be filled with the arguments provided by the hook function. All data transported with the arguments shall be provided.⌋ [SWS_Dlt_00632] ⌈The argument data shall be written in raw format to the payload.⌋ [SWS_Dlt_00279] ⌈Every hook function shall get its own DltSwcContextId. In some cases some events can be bundled to the same ContextId. This shall mostly be done if a very large number of signals are traced.⌋ [SWS_Dlt_00337] ⌈The ApplicationID shall be "VFBT".⌋ [SWS_Dlt_00484] ⌈The Message Type (MSTP) entry in the generated trace message shall be set to DLT_TYPE_APP_TRACE, the Message Trace Info (MSTI) entry in this case shall be set to DLT_TRACE_VFB.⌋ [SWS_Dlt_00280] ⌈Because non-verbose mode is used, a unique Message ID as defined in [SWS_Dlt_00031] shall be used for each call to Dlt_SendTraceMessage.⌋ Note: The description for the Message ID-payload shall be generated and provided. This description can be generated from the SW-C description file, were the interface is described. [SWS_Dlt_00281] ⌈In each hook function the trace status of the ContextId shall be checked, such that: /* Check the trace status of the ContextId before calling Dlt_SendTraceMessage "vfb_actual_trace_status_contextXY" holds the trace status for a specific ContextId */ if (vfb_actual_trace_status_contextXY) { <internal_Dlt_SendTraceMessage>(...); ⌋ [SWS_Dlt_00282] ⌈Dlt shall use for every VFB trace hook function an own DltSwcContextId and thus handle for every VFB trace DltSwcContextId a separate trace status. This can be done with a separate variable.⌋ [SWS_Dlt_00283] ⌈A separate function shall be implemented to modify the trace status of VFB trace hook functions. This function shall be harmonized with the SW-C LogTraceSessionControl interface.⌋