1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META http-equiv="Content-Style-Type" content="text/css"> 6<TITLE>NETGetWirelessMacAddress</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8</HEAD> 9<BODY> 10<H1>NETGetWirelessMacAddress</H1> 11 12<H2>Syntax</H2> 13<DL> 14 <DD><PRE><CODE>#include <revolution/net.h></CODE></PRE> 15 <DD><PRE><CODE>s32 NETGetWirelessMacAddress( u8* pAddr );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20Gets 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. 21</P> 22<P> 23Returns 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. 24</P> 25 26<H2>Arguments</H2> 27<TABLE border="1" cellpadding="3" cellspacing="0.1"> 28 <TR> 29 <TD width="120" bgcolor="#ffffe8"><code><em><strong>pAddr</strong></em></code></TD> 30 <TD width="520"> 31Specifies the buffer to which the MAC address is read. Writes 6 bytes of data to the specified address. 32 </TD> 33 </TR> 34</TABLE> 35 36<h2>Return Values</h2> 37<P> 38Returns zero for success. Otherwise, returns a negative value.<br> A value of -4 (<CODE>NCD_RESULT_EXCLUSIVE</CODE>) indicates that a mutex with another function caused the operation to fail. A value of -8 (<CODE>NCD_RESULT_INPROGRESS</CODE>) indicates that the wireless hardware has not finished initializing. <br><br>Treat other error values as errors unrecoverable even after a retry. 39</P> 40 41<H2>See Also</H2> 42<P> 43None. 44</P> 45 46<H2>Revision History</H2> 47<P> 482008/02/29 Added error descriptions. <br>2007/01/31 Initial version. 49</P> 50 51<hr><p>CONFIDENTIAL</p></body> 52</HTML>