Hatteland Display HT B22 (Fanless) - Manual (Page 18)

DOC101356-1_ - rev 2 – 2013-09-24 - Created by:6644
Page 18 of 24
Hatteland Display AS, Åmsosen, N-5578 Nedre Vats, Norway
Tel: (+47) 4814 2200 - [email protected] - www.hatteland-display.com
HD CAN Module Programmer’s Guide (Linux)
All intellectual properties belongs to Hatteland Display AS
h) J2534_ERROR_CODE J2534::PassThruReadMsgs
( unsigned long channelID,
PASSTHRU_MSG
* pMsg,
unsigned long *
pNumMsgs
,
unsigned long timeout
)
This function reads messages and indications from the receive buffer. All messages and
indications shall be read in the order that they occurred on the bus. If a transmit
message generated a loopback message and TxDone indication, the TxDone indication
shall always be queued first. Except for loopback messages and indications, no messages
shall be queued for reception without matching a PASS_FILTER (for non-ISO 15765) or
FLOW_CONTROL filter (for ISO 15765). On ISO 15765, PCI bytes are transparently
removed by the API. If the function is successful, a value of STATUS_NOERROR is
returned.
Parameters:
[in] channelID The channel ID assigned by the PassThruConnect function.
[in] *pMsg Pointer to start of messages.
[in] *pNumMsgs Pointer to location where number of messages to read is
specified.
[in] timeout Read timeout (in milliseconds). If a value of 0 is specified the
function retrieves up to pNumMsgs messages and returns
immediately. Otherwise, the API will not return until the
Timeout has expired, an error has occurred, or the desired
number of messages have been read. If the number of
messages requested have been read, the function shall not
return ERR_TIMEOUT, even if the timeout value is zero.
[out] *pMsg Pointer to message structure(s).
Returns:
Connect request status, see function return codes in hdj2534.h