PassThruStopMsgFilter v4.04 v5.0

Eliminación del filtro de mensajes

Última modificación: 11 de enero de 2026

Descripción

Esta función elimina uno de los filtros previamente establecidos.

long PassThruStopMsgFilter(unsigned long ChannelID, unsigned long FilterID)

Parámetros

unsigned long ChannelID - Identificador del canal guardado al establecer la conexión con el comando PassThruConnect.
unsigned long FilterID - Identificador del filtro que se elimina, creado anteriormente mediante PassThruStartMsgFilter.

Códigos de error devueltos

Código	Descripción	Posibles causas y soluciones
STATUS_NOERROR	La función se ejecutó correctamente	—
ERR_DEVICE_NOT_CONNECTED	No hay conexión con el adaptador	El adaptador está apagado o fuera de alcance Solución: compruebe la alimentación del adaptador y la conexión de red
ERR_INVALID_DEVICE_ID	Identificador de dispositivo no válido	El DeviceID no se obtuvo mediante PassThruOpen o el dispositivo ya está cerrado Solución: asegúrese de que PassThruOpen se ejecutó correctamente
ERR_INVALID_CHANNEL_ID	Identificador de canal no válido	El ChannelID no se obtuvo mediante PassThruConnect o el canal ya está cerrado Solución: asegúrese de que PassThruConnect se ejecutó correctamente
ERR_INVALID_FILTER_ID	Identificador de filtro no válido	El FilterID no se obtuvo mediante PassThruStartMsgFilter o el filtro ya se ha eliminado Solución: utilice el FilterID obtenido de PassThruStartMsgFilter
ERR_FAILED	Error indeterminado	Error interno de la biblioteca o del adaptador Solución: llame a `PassThruGetLastError()` para obtener la descripción

Ejemplos

Ejemplo en C/C++

#include "j2534_lib.hpp"

unsigned long ChannelID; // ID del canal
unsigned long FilterID;  // ID del filtro obtenido de PassThruStartMsgFilter
long Ret;

Ret = PassThruStopMsgFilter(ChannelID, FilterID);
if (Ret != STATUS_NOERROR)
{
    // Manejo del error
}

Ejemplo en Kotlin (Android)

// channelID y filterID obtenidos anteriormente
val result = j2534.ptStopMsgFilter(channelID, filterID)
if (result.status == STATUS_NOERROR) {
    // Filtro eliminado correctamente
    Log.i("J2534", "Filtro $filterID eliminado.")
} else {
    // Manejo del error
    Log.e("J2534", "Error al eliminar el filtro: ${result.status}")
}

Ejemplo en Python

from ctypes import *

# channelID y filterID obtenidos anteriormente
ret = j2534.PassThruStopMsgFilter(channel_id, filter_id)
if ret == 0:  # STATUS_NOERROR
    print(f"Filtro {filter_id} eliminado")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Error: {error.value.decode()}")

Ejemplo en C#

// channelID y filterID obtenidos anteriormente
int ret = J2534.PassThruStopMsgFilter(channelId, filterId);
if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Filtro {filterId} eliminado");
}
else
{
    var error = new StringBuilder(256);
    J2534.PassThruGetLastError(error);
    Console.WriteLine($"Error: {error}");
}