canFilterDestroy (Function)

canFilterDestroy will destroy a receive filter that is no longer needed. The filter ID retrieved from canFilterCreate, canFilterCreateOnce. or canFilterCreateX must be used to identify the filter.

Input:

filterid : SINT

ID for the filter to destroy.

Returns: SINT

Declaration:

FUNCTION canFilterDestroy : SINT;
VAR_INPUT
  filterid : SINT;
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR
  canRX : canReceiveMessage;
  buf   : ARRAY [1..8] OF SINT;
END_VAR;
 
PROGRAM CANExample;
VAR
  Filter_ID : SINT;
  cmd       : SINT;
END_VAR;
 
// Open can
canOpen(baud := 250);
canRX(data := ADDR(buf));
 
BEGIN
  ...
  IF cmd = 16#02 THEN
    // startID: Priority=3 Reserved=1 Data page=0 PGN=00FDD6
     Filter_ID := canFilterCreate(xtd:=TRUE,startID:=16#0EFDD600,length:=6);
  ELSIF cmd = 16#03 THEN
    canFilterDestroy(filterid:=Filter_ID);
  END_IF;
  ...
END;
 
END_PROGRAM;