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<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css">
8<TITLE>HIO2EnumDevices</TITLE>
9</HEAD>
10<BODY>
11<H1 align="left">HIO2EnumDevices</H1>
12<H2>C Specification</H2>
13<P>Target:</P>
14<DL>
15  <DD>
16<PRE><CODE>#include &lt;revolution/hio2.h&gt;</CODE></PRE>
17  <DD>
18<PRE><CODE>BOOL    HIO2EnumDevices( HIO2EnumCallback <EM>callback</EM> );</CODE></PRE>
19</DL>
20<P>s32</P>
21<DL>
22  <DD>
23<PRE><CODE>#include &lt;revolution/hio2.h&gt;</CODE></PRE>
24  <DD>
25<PRE><CODE>BOOL    HIO2EnumDevices( HIO2EnumCallback callback, void* param );</CODE></PRE>
26</DL>
27<H2>Arguments</H2>
28<P>Target:</P>
29<TABLE border="1" cellpadding="3" cellspacing="0.1">
30  <TBODY>
31    <TR>
32<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>callback</CODE></STRONG></EM> &nbsp;&nbsp;</TD>
33<TD width="520">Callback function to call if a connected HIO2 device is detected.</TD>
34    </TR>
35  </TBODY>
36</TABLE>
37<P>Host:</P>
38<TABLE border="1" cellpadding="3" cellspacing="0.1">
39  <TBODY>
40    <TR>
41<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>callback</CODE></STRONG></EM> &nbsp;&nbsp;</TD>
42<TD width="520">Callback function to call if a connected HIO2 device is detected.</TD>
43    </TR>
44    <TR>
45<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>param</CODE></STRONG></EM> &nbsp;&nbsp;</TD>
46<TD width="520">Parameters used with the callback function <EM><STRONG><CODE>callback</EM></STRONG></CODE>.</TD>
47    </TR>
48  </TBODY>
49</TABLE>
50<H2>Return Values</H2>
51<P>Target:</P>
52<P>Returns <CODE>TRUE</CODE> if enumeration succeeds and <CODE>FALSE</CODE> if enumeration fails.</P>
53<P>Host:</P>
54<p>Returns the number of HIO2 devices connected. Returns -1 if an error occurs.</p>
55<H2>Description</H2>
56<P><STRONG>Target:</STRONG> The <CODE>HIO2EnumDevices</CODE> function enumerates the HIO2 devices connected to the target EXI port. If a device is detected, the callback function <EM><STRONG><CODE>callback</CODE></STRONG></EM> is called using the detected EXI device type as a parameter. Devices are enumerated in this order: <CODE>HIO2_DEVICE_EXI2USB_0</CODE> &#x2192; <CODE>HIO2_DEVICE_EXI2USB_1</CODE> &#x2192; <CODE>HIO2_DEVICE_MrEXI.</CODE></P>
57<P><STRONG>Host:</STRONG> The <CODE>HIO2EnumDevices</CODE> function enumerates the HIO2 devices connected to the host. If a device is detected, the callback function <EM><STRONG><CODE>callback</CODE></STRONG></EM> is called using the detected device names and parameters that <EM><STRONG><CODE>param</CODE></STRONG></EM> specifies as parameters.</P>
58<H2>See Also</H2>
59<P><CODE><A href="HIO2Init.html">HIO2Init</A></CODE><br> <CODE><A href="HIO2EnumCallback.html">HIO2EnumCallback</A></CODE><BR>
60</P>
61<H2>Revision History</H2>
62<P>03/01/2006 Initial version.</P>
63<P>05/29/2006 Added link to HIO2EnumCallback</P>
64<P>07/18/2006 Revised mistake in the description of the return value on the host side.</P>
65<hr>
66<P>CONFIDENTIAL</p>
67</BODY>
68</HTML>