PassThruWriteMsgs Messaging

Description

The function sends messages according to the diagnostic protocol. The transmit queue of the adapter is designed for 50 messages per queue for one channel and has 64 KB of free memory for all queues. When the queue or all free memory is full, the reception of messages in the transmitting queue is suspended.

long PassThruWriteMsgs(unsigned long ChannelID, PASSTHRU_MSG *pMsg, unsigned long *pNumMsgs, unsigned long Timeout)

Options

unsigned long ChanneID - PassThruConnect saved channel identifier during communication.
PASSTHRU_MSG* pMsg - Pointer to an array of message structures. Messages are taken from this array for transmission according to the diagnostic protocol.
unsigned long* pNumMsgs - Pointer to a variable in which the number of messages ordered for transmission is located. After the function is executed, the number of actually transmitted messages is written to this variable.
unsigned long Timeout - The time during which the specified messages will be transmitted. If after the end of the timeout the number of actually transmitted messages does not match the number of ordered messages, an error code ERR_TIMEOUT is issued. Not the full number of received messages will be available in the buffer.
If the timeout is 0, then all messages are added to the transmit queue without waiting for a physical transfer. And the function returns the answer as quickly as possible. Messages will be transmitted for some time in accordance with the timings specified by the protocol. However, the error ERR_TIMEOUT is not generated.

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_INVALID_CHANNEL_ID	Set a non-existent channel identifier ChannelID
ERR_NULL_PARAMETER	PMsg Receive Packet Buffer Pointer Not Set
ERR_TIMEOUT	For a given time, they could not transmit all the messages.
ERR_INVALID_MSG	Incorrect message structure specified in pMsg pointer.
ERR_NULL_PARAMETER	PMsg pointer not set
ERR_MSG_PROTOCOL_ID	The protocol specified in the parameters of the transmitted message does not match the protocol specified in ChannelID
ERR_NO_FLOW_CONTROL	The ISO15765 protocol does not have a filter for Flow Control.
ERR_BUFFER_FULL	The transfer queue is full.
ERR_FAILED	Defined by the J2534 standard. In the adapter, it is not used for this function.

Example

#include "j2534_lib.hpp"

unsigned long ChannelID;
unsigned long NumMsgs;
long Ret;

PASSTHRU_MSG Msg[10];

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

NumMsgs = 1;
Ret = PassThruWriteMsgs(ChannelID, Msg, &NumMsgs, 100);
if (Ret != STATUS_NOERROR)
{	// Error handling
}