NETGetWirelessMacAddress

Syntax

#include <revolution/net.h>

s32     NETGetWirelessMacAddress( u8* pAddr );

Description

Gets the MAC address of the Wi-Fi module. Always gets the MAC address for the Wi-Fi module, regardless of the network interface in use with the current network settings.

Returns an error during the period after startup until the wireless hardware has finished initializing. A mutex (mutual exclusion) error may also occur if other network-related functions are being called. If one of these errors occurs, call this function again after a short period of time.

Arguments

pAddr Specifies the buffer to which the MAC address is read. Writes 6 bytes of data to the specified address.

Return Values

Returns zero for success. Otherwise, returns a negative value.
A value of -4 (NCD_RESULT_EXCLUSIVE) indicates that a mutex with another function caused the operation to fail. A value of -8 (NCD_RESULT_INPROGRESS) indicates that the wireless hardware has not finished initializing.

Treat other error values as errors unrecoverable even after a retry.

Revision History

2008/02/29 Added error descriptions.
2007/01/31 Initial version.