Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Task Controller Interaction Layer (TC IL) » TCIL_BlockTxTpDpo

​
TCIL_BlockTxTpDpo

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long TCIL_BlockTxTpDpo(long dpoToBlock); //Form 1
  • long TCIL_BlockTxTpDpo(dbNode node, long dpoToBlock); //Form 2

​
Description

Prevents transmitting of a ETP.DPO message generated and sent by the interaction layer. The message to be blocked is identified by its occurrences on the bus, starting at 1. The given DPO message is blocked every time until the CAPL function TCIL_ResetBlockedTxTpDpo is called.

​
Parameters

  • dpoToBlock: The ETP.DPO message that shall be blocked.
  • node: Simulation node to apply the function.

​
Return Values

  • 0: OK
  • -3001: General Error
  • -3002: Parameter dpoToBlock must be greater than 0

​
Example

on start {
  long res;
  res = TCIL_BlockTxTpDpo(1); // Block the first ETP.DPO message
  if(res != 0)
  {
    write("An error occurred: %d", res);
  }
}