PassThruStopMsgFilter v4.04 v5.0

Usuwanie filtra wiadomości

Ostatnia zmiana: 11 stycznia 2026 r.

Opis

Ta funkcja usuwa jeden z wcześniej ustawionych filtrów.

long PassThruStopMsgFilter(unsigned long ChannelID, unsigned long FilterID)

Parametry

unsigned long ChannelID - Identyfikator kanału zapisany podczas nawiązywania połączenia poleceniem PassThruConnect.
unsigned long FilterID - Identyfikator usuwanego filtra, który został wcześniej utworzony za pomocą PassThruStartMsgFilter.

Zwracane kody błędów

Kod	Opis	Możliwe przyczyny i rozwiązania
STATUS_NOERROR	Funkcja wykonana pomyślnie	—
ERR_DEVICE_NOT_CONNECTED	Brak połączenia z adapterem	Adapter jest wyłączony lub poza zasięgiem Rozwiązanie: sprawdź zasilanie adaptera i połączenie sieciowe
ERR_INVALID_DEVICE_ID	Nieprawidłowy identyfikator urządzenia	DeviceID nie został uzyskany za pomocą PassThruOpen lub urządzenie jest już zamknięte Rozwiązanie: upewnij się, że PassThruOpen został wykonany pomyślnie
ERR_INVALID_CHANNEL_ID	Nieprawidłowy identyfikator kanału	ChannelID nie został uzyskany za pomocą PassThruConnect lub kanał jest już zamknięty Rozwiązanie: upewnij się, że PassThruConnect został wykonany pomyślnie
ERR_INVALID_FILTER_ID	Nieprawidłowy identyfikator filtra	FilterID nie został uzyskany za pomocą PassThruStartMsgFilter lub filtr został już usunięty Rozwiązanie: użyj FilterID uzyskanego z PassThruStartMsgFilter
ERR_FAILED	Błąd nieokreślony	Wewnętrzny błąd biblioteki lub adaptera Rozwiązanie: wywołaj `PassThruGetLastError()`, aby uzyskać opis

Przykłady

Przykład w C/C++

#include "j2534_lib.hpp"

unsigned long ChannelID; // ID kanału
unsigned long FilterID;  // ID filtra uzyskany z PassThruStartMsgFilter
long Ret;

Ret = PassThruStopMsgFilter(ChannelID, FilterID);
if (Ret != STATUS_NOERROR)
{
    // Obsługa błędu
}

Przykład w Kotlin (Android)

// channelID i filterID uzyskane wcześniej
val result = j2534.ptStopMsgFilter(channelID, filterID)
if (result.status == STATUS_NOERROR) {
    // Filtr został pomyślnie usunięty
    Log.i("J2534", "Filtr $filterID usunięty.")
} else {
    // Obsługa błędu
    Log.e("J2534", "Błąd usuwania filtra: ${result.status}")
}

Przykład w Python

from ctypes import *

# channelID i filterID uzyskane wcześniej
ret = j2534.PassThruStopMsgFilter(channel_id, filter_id)
if ret == 0:  # STATUS_NOERROR
    print(f"Filtr {filter_id} usunięty")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Błąd: {error.value.decode()}")

Przykład w C#

// channelID i filterID uzyskane wcześniej
int ret = J2534.PassThruStopMsgFilter(channelId, filterId);
if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Filtr {filterId} usunięty");
}
else
{
    var error = new StringBuilder(256);
    J2534.PassThruGetLastError(error);
    Console.WriteLine($"Błąd: {error}");
}