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>WDGetRadioLevel</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../CSS/rex.css"> 8</HEAD> 9<BODY> 10<H1>WDGetRadioLevel</H1> 11 12<H2>C Specification</H2> 13<DL> 14 <DD><PRE><CODE>#include <revolution/wd/WDApi.h></CODE></PRE> 15 <DD><PRE><CODE>u8 WDGetRadioLevel( const <a href="WDBssDesc.html">WDBssDesc</a>* <em>bssDesc</em> );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20 Searches for BSS information and gets the target signal strength level. 21 22</P> 23<P style="background-color:ffe8ff;padding-top:4px;padding-bottom:4px;padding-left:4px;padding-right:4px;"> 24 <strong>Note: </strong>The sent signal strength varies greatly between typical wireless access points and mobile devices. For this reason, if the signal strength level of mobile devices is calculated with the same standard, the result may show a weak level even though there is sufficient strength for communication. In order to get the signal strength level for the MP communications parent, use the API provided in the MP library. 25</P> 26 27<H2>Arguments</H2> 28<TABLE border="1" cellpadding="3" cellspacing="0.1"> 29 <TR> 30 <TH><em>bssDesc</em></TH> 31 <TD> 32 Sets the pointer to the start of the BSS information of the <CODE><a href="WDBssDesc.html">WDBssDesc</a></CODE> type to check.<br>If <CODE>NULL</CODE> is specified, the last received signal will be the target. 33 </TD> 34 </TR> 35</TABLE> 36 37<h2>Return Values</h2> 38<P> 39 Returns a signal strength level from <CODE>0</CODE> to <CODE>3</CODE>, calculated from the signal strength information contained in the BSS information.<br>If <CODE>NULL</CODE> is specified for <CODE><strong><em>bssDesc</em></strong></CODE>, returns the signal strength level of the signal received last. At this time, if the communication is not through the wireless module, the result will be <CODE>0</CODE>. 40</P> 41<TABLE border="1" cellpadding="3" cellspacing="0.1"> 42 <TR> 43 <TH>3</TH> 44 <TD>This signal strength is extremely capable for communication.</TD> 45 </TR> 46 <TR> 47 <TH>2</TH> 48 <TD>This signal strength is capable of communication.</TD> 49 </TR> 50 <TR> 51 <TH>1</TH> 52 <TD>This signal strength is barely capable of communication.</TD> 53 </TR> 54 <TR> 55 <TH>0</TH> 56 <TD>This signal strength so low that almost no communication can occur.</TD> 57 </TR> 58</TABLE> 59 60<H2>See Also</H2> 61<P> 62 <CODE><a href="WDScanOnce.html">WDScanOnce</a><br> <a href="WDFindGameInfo.html">WDFindGameInfo</a><br> <a href="WDBssDesc.html">WDBssDesc</a><br></CODE> 63</P> 64 65<H2>Revision History</H2> 66<P> 67 2006/12/12 Initial version.<br> 68</P> 69 70<hr><p>CONFIDENTIAL</p></body> 71</HTML> 72