Sys Tec Electronic GW-003 - Ethcangetconnectionstate

CAN – Ethernet Gateway
80 © SYS TEC electronic GmbH 2007 L-1032e_9
7.3.2.7 EthCanGetConnectionState
Syntax:
DWORD PUBLIC EthCanGetConnectionState(
tEthCanHandle EthCanHandle_p,
tConnectionState* pState_p);
Usability:
HW_INIT
Parameter:
EthCanHandle_p: Instance handle of the CAN-Ethernet Gateway
pState_p: Address to the connection status variable. This
address cannot be NULL!
Description:
This function returns the current connection status of the CAN-
Ethernet Gateway. If there was no callback function declared upon
initialization of the Gateway, then this function can be used to call up
the connection status with a polling procedure. This function should
be used if the initialization and de-initialization routines have been
called in „Blocked Mode“.
The parameter pState_p returns the current connection status after the
function has been called and can take on the values as previously
described in
Figure 16.
Return Values:
(see Section 7.3.3)
ETHCAN_SUCCESSFUL
ETHCAN_ERR_ILLHANDLE
ETHCAN_ERR_ILLPARAM
ETHCAN_ERR_HWNOINIT