8.6. Link Layer Control Interface

8.6.1. emIoControl - EC_IOCTL_ISLINK_CONNECTED

emIoControl - EC_IOCTL_ISLINK_CONNECTED

Parameter

• pbyInBuf: [in] Should be set to EC_NULL

• dwInBufSize: [in] Should be set to 0

• pbyOutBuf: [out] Pointer to buffer of type struct EC_T_LINK_CONNECTED_INFO

• dwOutBufSize: [in] Size of the output buffer in bytes, sizeof(EC_T_LINK_CONNECTED_INFO)

• pdwNumOutData: [out] Pointer to EC_T_DWORD. Amount of bytes written to the output buffer

Return

EC_E_NOERROR or error code

struct EC_T_LINK_CONNECTED_INFO

Public Members

EC_T_BOOL bConnected

[out] MAIN or RED link detected

EC_T_BOOL bSendEnabled

[out] send enabled on MAIN or RED

EC_T_BOOL bMainConnected

[out] MAIN link detected

EC_T_BOOL bMainMasked

[out] MAIN link not used for sending, because topology changed delay not elapsed yet

EC_T_BOOL bRedConnected

[out] RED link detected

EC_T_BOOL bRedMasked

[out] RED link not used for sending, because topology changed delay not elapsed yet

8.6.2. emIoControl - EC_IOCTL_GET_LINKLAYER_MODE

emIoControl - EC_IOCTL_GET_LINKLAYER_MODE

Parameter

• pbyInBuf: [in] Should be set to EC_NULL

• dwInBufSize: [in] Should be set to 0

• pbyOutBuf: [out] Pointer to buffer of type struct EC_T_LINKLAYER_MODE_DESC

• dwOutBufSize: [in] Size of the output buffer in bytes, sizeof(EC_T_LINKLAYER_MODE_DESC)

• pdwNumOutData: [out] Pointer to EC_T_DWORD. Amount of bytes written to the output buffer

Return

EC_E_NOERROR or error code

struct EC_T_LINKLAYER_MODE_DESC

Public Members

EC_T_LINKMODE eLinkMode

[out] Operation mode of main interface

EC_T_LINKMODE eLinkModeRed

[out] Operation mode of redundancy interface

8.6.3. emIoControl - EC_LINKIOCTL…

The generic control interface provides access to the main network adapter when adding EC_IOCTL_LINKLAYER_MAIN to the EC_LINKIOCTL parameter at dwCode.

EC_T_DWORD dwCode = (EC_IOCTL_LINKLAYER_MAIN | EC_LINKIOCTL_GET_ETHERNET_ADDRESS);

8.6.4. emIoControl - EC_LINKIOCTL_GET_ETHERNET_ADDRESS

Provides MAC addresses of main or red line.

emIoControl - EC_LINKIOCTL_GET_ETHERNET_ADDRESS

Parameter

• pbyInBuf: [in] Should be set to EC_NULL

• dwInBufSize: [in] Should be set to 0

• pbyOutBuf: [out] Pointer to MAC address buffer (6 bytes).

• dwOutBufSize: [in] Size of the output buffer in bytes (at least 6).

• pdwNumOutData: [out] Pointer to EC_T_DWORD. Amount of bytes written to the output buffer.

Return

EC_E_NOERROR or error code

8.6.5. emIoControl - EC_LINKIOCTL_GET_SPEED

emIoControl - EC_LINKIOCTL_GET_SPEED

Parameter

• pbyInBuf: [in] Should be set to EC_NULL

• dwInBufSize: [in] Should be set to 0

• pbyOutBuf: [out] Pointer to EC_T_DWORD. Set by Link Layer driver to 10/100/1000.

• dwOutBufSize: [in] Size of the output buffer in bytes.

• pdwNumOutData: [out] Pointer to EC_T_DWORD. Amount of bytes written to the output buffer.

Return

EC_E_NOERROR or error code