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 <revolution/hio2.h></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 <revolution/hio2.h></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> </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> </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> </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> → <CODE>HIO2_DEVICE_EXI2USB_1</CODE> → <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>