CLASSIC
Modul: comstack
Rolle: heuristic
Konfidenz: 80%
SNIP_CLASSIC_COMSTACK_SECTION_8_6_3_1_LdComCbkCopyTxData
Wortlaut
8.6.3.1 LdComCbkCopyTxData
[SWS_LDCOM_91001] Definition of configurable interface <LdComUser_LdCom
CbkCopyTxData>
Status:
DRAFT
Upstream requirements: SRS_Com_02109, SRS_Com_02114
⌈
Service Name
<LdComUser_LdComCbkCopyTxData> (draft)
Syntax
BufReq_ReturnType <LdComUser_LdComCbkCopyTxData> (
CbkHandleIdType LdComUserCbkHandleId,
const PduInfoType* info,
const RetryInfoType* retry,
PduLengthType* availableDataPtr
)
Sync/Async
Synchronous
Reentrancy
Non Reentrant for same LdComUserCbkHandleId, otherwise Reentrant
LdComUserCbkHandleId
LdCom user callback handle Id corresponding to the transmitted
I-PDU
info
Provides the destination buffer (SduDataPtr) and the number of
bytes to be copied (SduLength). If not enough transmit data is
available, no data is copied by the upper layer module and
BUFREQ_E_BUSY is returned. The lower layer module may
retry the call. An SduLength of 0 can be used to indicate state
changes in the retry parameter or to query the current amount of
available data in the upper layer module. In this case, the Sdu
DataPtr may be a NULL_PTR.
Parameters (in)
retry
Will not be handled by LdCom and its upper layer.
Parameters (inout)
None
Parameters (out)
availableDataPtr
Indicates the remaining number of bytes that are available in the
upper layer module’s Tx buffer. availableDataPtr can be used by
TP modules that support dynamic payload lengths (e.g. FrIsoTp)
to determine the size of the following CFs.
Return value
BufReq_ReturnType
BUFREQ_OK: Data has been copied to the transmit buffer
completely as requested.
BUFREQ_E_BUSY: Request could not be fulfilled, because the
required amount of Tx data is not available. The lower layer
module may retry this call later on. No data has been copied.
BUFREQ_E_NOT_OK: Data has not been copied. Request failed.
Description
This function is called to acquire the transmit data of an I-PDU segment (N-PDU). Each call to
this function provides the next part of the I-PDU data unless retry->TpDataState is TP_
DATARETRY. In this case the function restarts to copy the data beginning at the offset from the
current position indicated by retry->TxTpDataCnt. The size of the remaining data is written to
the position indicated by availableDataPtr
Tags: atp.Status=draft
Available via
LdComUserHeaderInclude ([ECUC_LdCom_xxx04])
⌋
Versionen & Provenienz · Zugeordnete Anforderungen
Diese Angaben zeigt der Versions-Explorer.
Begründung & Zuweisungs-Evidenz
RTE signature for LdComCbkCopyTxData
Dokumenten-Herkunft & Rückverfolgbarkeit
| Spezifikations-Dokument | SWS_LargeDataCOM.pdf |
|---|---|
| Dokumentseite | Seite 34 |
| Ziel-Modul | comstack (classic) |
| Ziel-Anforderung | SWS_Rte_91133 |
| Semantische Rolle | heuristic |
| Automatisierungs-Konfidenz | 0.80 |