Skip to main content
Open topic with navigation CAPL Functions » Ethernet » Function Overview » ethernetPacket::GetPDU

​
ethernetPacket::GetPDU

Valid for: CANoe DE • CANoe4SW DE

​
Method Syntax

long ethernetPacket.GetPDU(long n, PDU * P);

​
Description

Retrieves the PDU with index n in this packet.

​
Parameters

  • n: Index of the requested PDU. The first PDU has index n = 0, the last PDU has index n = PDUCount() - 1.
  • P: Resulting PDU is copied here. The parameter P must be of type PDU *.

​
Return Values

  • 0: Data access successful.
  • -1: Wrong bus system.
  • -2: This frame does not support accessing PDUs.
  • -3: The PDU object is invalid.
  • -4: PDU is not of RX type.
  • -5: Parameter too small (e.g. array has too few bytes).
  • -6: Message or PDU is not available (any more).
  • -7: PDU index out of bound. Use selector PDUCount() to determine the number of PDUs.

​
Example

ethernetPacket packet;
pdu* aPDU;

if(packet.PDUCount()>0)
{
  write("second pdu starts at %d bytes", packet.PDUOffset(1));
  packet.GetPDU(1, aPDU);
  write("pdu longheader: %d, %s", aPDU.LongHeaderID, aPDU.fullQualifiedName);
}
See Also