SNIP_CLASSIC_CANIF_SECTION_8_4_1_CanIf_TriggerTransmit

8.4.1 CanIf_TriggerTransmit [SWS_CANIF_00883] Definition of callback function CanIf_TriggerTransmit ⌈ Service Name CanIf_TriggerTransmit Syntax Std_ReturnType CanIf_TriggerTransmit ( PduIdType TxPduId, PduInfoType* PduInfoPtr ) Service ID [hex] 0x41 Sync/Async Synchronous Reentrancy Reentrant for different PduIds. Non reentrant for the same PduId. Parameters (in) TxPduId ID of the SDU that is requested to be transmitted. Parameters (inout) PduInfoPtr Contains a pointer to a buffer (SduDataPtr) to where the SDU data shall be copied, and the available buffer size in SduLengh. On return, the service will indicate the length of the copied SDU data in SduLength. Parameters (out) None Return value Std_ReturnType E_OK: SDU has been copied and SduLength indicates the number of copied bytes. E_NOT_OK: No SDU data has been copied. PduInfoPtr must not be used since it may contain a NULL pointer or point to invalid data. Description Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by PduInfoPtr->SduLength. If it fits, it shall copy its data into the buffer provided by PduInfoPtr->SduDataPtr and update the length of the actual copied data in PduInfoPtr->SduLength. If not, it returns E_NOT_OK without changing PduInfoPtr. Available via CanIf.h ⌋() [SWS_CANIF_00884] ⌈CanIf shall only provide the API function CanIf_TriggerTransmit() if TriggerTransmit support is enabled (CanIfTriggerTransmitSupport = TRUE).⌋() [SWS_CANIF_00885] ⌈The function CanIf_TriggerTransmit() shall call the corresponding <User_TriggerTransmit>() function, passing the translated TxPduId and the pointer to the PduInfo structure (PduInfoPtr). Upon return, CanIf_TriggerTransmit() shall return the return value of its <User_TriggerTransmit>().⌋ ()