PassThru StopMsgFilter Удаление фильтра сообщений

Последнее изменение: 22 октября 2025 г.

Описание

Эта функция удаляет один из ранее установленных фильтров.

long PassThruStopMsgFilter(unsigned long ChannelID, unsigned long FilterID)

Параметры

unsigned long ChanneID - Сохранённый при установлении связи командой PassThruConnect идентификатор канала.
unsigned long FilterID, - Идентификатор удаляемого фильтра, которой был создан ранее.

Возвращаемые коды ошибок

Определение	Описание
STATUS_NOERROR	Функция выполнена успешно
ERR_DEVICE_NOT_CONNECTED	Нет соединения с адаптером. Возможные причины: Адаптер выключен, нет сети, или не правильно задан IP адрес.
ERR_INVALID_DEVICE_ID	Задан не существующий идентификатор адаптера DeviceID
ERR_INVALID_CHANNEL_ID	Задан не существующий идентификатор канала ChannelID
ERR_INVALID_idfilter	Задан не существующий идентификатор фильтра FilterID
ERR_FAILED	Внутренняя ошибка в dll или в микропрограммы адаптере. Такие как ошибка выделения памяти или сбой стека. Для получения поробностей нужно использовать функцию `PassThruGetLastError()`

Примеры

Пример на C/C++

#include "j2534_lib.hpp"

unsigned long ChannelID; // ID канала
unsigned long FilterID;  // ID фильтра, полученный от PassThruStartMsgFilter
long Ret;

Ret = PassThruStopMsgFilter(ChannelID, FilterID);
if (Ret != STATUS_NOERROR)
{
    // Обработка ошибки
}

Пример на Kotlin (Android)

// channelID и filterID получены ранее
val result = j2534.ptStopMsgFilter(channelID, filterID)
if (result.status == STATUS_NOERROR) {
    // Фильтр успешно удален
    Log.i("J2534", "Фильтр $filterID удален.")
} else {
    // Обработка ошибки
    Log.e("J2534", "Ошибка удаления фильтра: ${result.status}")
}