Skip to main content
Open topic with navigation CAPL Functions » ISO11783 » Virtual Terminal Interaction Layer (VT IL) » VTIL_BlockTxTpDpo

​
VTIL_BlockTxTpDpo

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

  • long VTIL_BlockTxTpDpo(long dpoToBlock); //Form 1
  • long VTIL_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 VTIL_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 = VTIL_BlockTxTpDpo(1); // Block the first ETP.DPO message
  if(res != 0)
  {
    write("An error occurred: %d", res);
  }
}