Get network interface’s hardware address.
Files
net_if.h/net_if.c
Prototype
Code Block |
---|
void NetIF_AddrHW_Get(NET_IF_NBR if_nbr,
CPU_INT08U *p_addr_hw,
CPU_INT08U *p_addr_len,
NET_ERR *p_err); |
Arguments
if_nbr
Network interface number to get the hardware address.
paddrp_addr_hw
Pointer to variable that will receive the hardware address.
paddrp_addr_len
Pointer to a variable to pass the length of the address buffer pointed to by paddrp_addr_hw
and return the size of the returned hardware address, if no errors.
perr
p_err
Pointer to variable that will receive the return error code from this function:
NET_IF_ERR_NONE
NET_IF_ERR_NULL_PTR
NET_IF_ERR_NULL_FNCT
NET_IF_ERR_INVALID_IF
NET_IF_ERR_INVALID_CFG
NET_IF_ERR_INVALID_ADDR_LEN
NET_OSERR_ERRFAULT_LOCK_ACQUIRE
Returned Value
None.
Required Configuration
None.
Notes / Warnings
The hardware address is returned in network-order; i.e., the pointer to the hardware address points to the highest-order byte. Additional error codes may be returned by the specific interface or device driver.