DE RU EN EL

PassThru StartPeriodicMsg Start a periodic message

Description

This function allows you to set a message that will be displayed at a specified interval.

long PassThruStartPeriodicMsg(unsigned long ChannelID, PASSTHRU_MSG* pMsg, unsigned long* MsgID, unsigned long TimeInterval)

Options

unsigned long ChanneID - PassThruConnect saved channel identifier during communication.
PASSTHRU_MSG* pMsg - Pointer to the displayed message. The message length is 12 bytes or less including the header. A periodic message has high priority in the message queue, but does not violate P3min timing.
unsigned long* pMsgID, - Return pointer to the periodic message. Subsequently needed to delete a periodic message.
unsigned long TimeInterval - The interval in which the message is displayed in milliseconds. 5-65535 millisecond period range

Returned error codes

Definition	Description
STATUS_NOERROR	Function completed successfully
ERR_DEVICE_NOT_CONNECTED	No connection to adapter. Possible reasons: The adapter is turned off, there is no network, or the IP address is not set correctly.
ERR_INVALID_DEVICE_ID	Set a non-existent adapter ID DeviceID
ERR_NOT_SUPPORTED	The adapter does not support the requested parameters. For example, the repetition interval time is less than 20ms.
ERR_INVALID_MSG	Invalid message structure specified in pMsg pointer
ERR_INVALID_CHANNEL_ID	Set a non-existent channel identifier ChannelID
ERR_NULL_PARAMETER	PMsg pointer not set
ERR_INVALID_TIME_INTERVAL	Message interval set incorrectly
ERR_MSG_PROTOCOL_ID	The protocol specified in the parameters of the transmitted message does not match the protocol specified in ChannelID
ERR_EXCEEDED_LIMIT	The number of set periodic messages has been exceeded.
ERR_FAILED	Defined by the J2534 standard. In the adapter, it is not used for this function.

Example

#include "j2534_lib.hpp"

unsigned long DeviceID;
long Ret;

unsigned long ChannelID;
unsigned long MsgID;
PASSTHRU_MSG Msg;

Msg.ProtocolID = ISO15765;
Msg.TxFlags = ISO15765_FRAME_PAD;
Msg.Data[0] = 0x00;
Msg.Data[1] = 0x00;
Msg.Data[2] = 0x07;
Msg.Data[3] = 0xE0;
Msg.Data[4] = 0x3E;
Msg.DataSize = 5;

Ret = PassThruStartPeriodicMsg(ChannelID, &Msg, &MsgID, 500);
if (Ret != STATUS_NOERROR)
{	// Error handling
}