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><STRONG>Target:</STRONG></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><STRONG>Host:</STRONG></P>
21<DL>
22  <DD>
23  <PRE><CODE>#include &lt;revolution/hio2.h&gt;</CODE></PRE>
24  <DD>
25  <PRE><CODE>s32     HIO2EnumDevices( HIO2EnumCallback <EM>callback</EM>, void* <EM>param</EM> );</CODE></PRE>
26</DL>
27<H2>Arguments</H2>
28<P><STRONG>Target:</STRONG></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><STRONG>Host:</STRONG></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><STRONG>Target:</STRONG></P>
52<P>Returns <CODE>TRUE</CODE> if enumeration succeeds and <CODE>FALSE</CODE> if enumeration fails.</P>
53<P><STRONG>Host:</STRONG></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 an argument. 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 path names and arguments 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>2006/12/21 Corrected mistake in the type of the return value on the host side.</P>
63<P>2006/07/18 Revised mistake in the description of the return value on the host side.</P>
64<P>2006/05/29 Added link to HIO2EnumCallback</P>
65<P>2006/03/01 Initial version.</P>
66<hr>
67<P>CONFIDENTIAL</p>
68</BODY>
69</HTML>