PassThruStopMsgFilter v4.04 v5.0

Suppression du filtre de messages

Dernière modification : 11 janvier 2026

Description

Cette fonction supprime l'un des filtres précédemment établis.

long PassThruStopMsgFilter(unsigned long ChannelID, unsigned long FilterID)

Paramètres

unsigned long ChannelID - Identifiant du canal enregistré lors de l'établissement de la connexion avec la commande PassThruConnect.
unsigned long FilterID - Identifiant du filtre à supprimer, créé précédemment via PassThruStartMsgFilter.

Codes d'erreur renvoyés

Code	Description	Causes possibles et solutions
STATUS_NOERROR	La fonction s'est exécutée correctement	—
ERR_DEVICE_NOT_CONNECTED	Aucune connexion avec l'adaptateur	L'adaptateur est éteint ou hors de portée Solution : vérifiez l'alimentation de l'adaptateur et la connexion réseau
ERR_INVALID_DEVICE_ID	Identifiant de périphérique non valide	Le DeviceID n'a pas été obtenu via PassThruOpen ou le périphérique est déjà fermé Solution : assurez-vous que PassThruOpen s'est exécuté correctement
ERR_INVALID_CHANNEL_ID	Identifiant de canal non valide	Le ChannelID n'a pas été obtenu via PassThruConnect ou le canal est déjà fermé Solution : assurez-vous que PassThruConnect s'est exécuté correctement
ERR_INVALID_FILTER_ID	Identifiant de filtre non valide	Le FilterID n'a pas été obtenu via PassThruStartMsgFilter ou le filtre a déjà été supprimé Solution : utilisez le FilterID obtenu de PassThruStartMsgFilter
ERR_FAILED	Erreur indéterminée	Erreur interne de la bibliothèque ou de l'adaptateur Solution : appelez `PassThruGetLastError()` pour obtenir la description

Exemples

Exemple en C/C++

#include "j2534_lib.hpp"

unsigned long ChannelID; // ID du canal
unsigned long FilterID;  // ID du filtre obtenu de PassThruStartMsgFilter
long Ret;

Ret = PassThruStopMsgFilter(ChannelID, FilterID);
if (Ret != STATUS_NOERROR)
{
    // Gestion de l'erreur
}

Exemple en Kotlin (Android)

// channelID et filterID obtenus précédemment
val result = j2534.ptStopMsgFilter(channelID, filterID)
if (result.status == STATUS_NOERROR) {
    // Filtre supprimé avec succès
    Log.i("J2534", "Filtre $filterID supprimé.")
} else {
    // Gestion de l'erreur
    Log.e("J2534", "Erreur de suppression du filtre : ${result.status}")
}

Exemple en Python

from ctypes import *

# channelID et filterID obtenus précédemment
ret = j2534.PassThruStopMsgFilter(channel_id, filter_id)
if ret == 0:  # STATUS_NOERROR
    print(f"Filtre {filter_id} supprimé")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Erreur : {error.value.decode()}")

Exemple en C#

// channelID et filterID obtenus précédemment
int ret = J2534.PassThruStopMsgFilter(channelId, filterId);
if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Filtre {filterId} supprimé");
}
else
{
    var error = new StringBuilder(256);
    J2534.PassThruGetLastError(error);
    Console.WriteLine($"Erreur : {error}");
}