SNIP_CLASSIC_COMSTACK_SECTION_8_4_3_DoIP_SoAdTpCopyRxData

8.4.3 DoIP_SoAdTpCopyRxData [SWS_DoIP_00033] Definition of callback function DoIP_SoAdTpCopyRxData Upstream requirements: RS_Diag_00024 ⌈ Service Name DoIP_SoAdTpCopyRxData Syntax BufReq_ReturnType DoIP_SoAdTpCopyRxData ( PduIdType id, const PduInfoType* info, PduLengthType* bufferSizePtr ) Service ID [hex] 0x44 Sync/Async Synchronous Reentrancy Reentrant for different PduIds. Non reentrant for the same PduId. id Identification of the received I-PDU. Parameters (in) info Provides the source buffer (SduDataPtr) and the number of bytes to be copied (SduLength). An SduLength of 0 can be used to query the current amount of available buffer in the upper layer module. In this case, the SduDataPtr may be a NULL_PTR. Parameters (inout) None Parameters (out) bufferSizePtr Available receive buffer after data has been copied. Return value BufReq_ReturnType BUFREQ_OK: Data copied successfully BUFREQ_E_NOT_OK: Data was not copied because an error occurred. Description This function is called to provide the received data of an I-PDU segment (N-PDU) to the upper layer. Each call to this function provides the next part of the I-PDU data. The size of the remaining buffer is written to the position indicated by bufferSizePtr. Available via DoIP.h ⌋ [SWS_DoIP_00183] ⌈If DoIPDevelopmentErrorDetect is enabled: DoIP_SoAdTpCopyRxData() shall check that the service DoIP_Init() was previously called. If the check fails, the function shall raise the development error DOIP_E_UNINIT.⌋ [SWS_DoIP_00036] ⌈If DoIPDevelopmentErrorDetect is enabled: DoIP_SoAdTpCopyRxData() shall check if the id matches a configured DoIPSoAdTcpRxPduId. If the check fails, the function shall raise the development error DOIP_E_ INVALID_PDU_SDU_ID.⌋ [SWS_DoIP_00184] ⌈If DoIPDevelopmentErrorDetect is enabled: DoIP_SoAdTpCopyRxData() shall check that neither the info nor the bufferSizePtr are a NULL_PTR. If the check fails, the function shall raise the development error DOIP_E_PARAM_POINTER.⌋