Skip to main content

Documentation Index

Fetch the complete documentation index at: https://notevil.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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);
  }
}