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 9<TITLE>HIO2WriteAsync</TITLE> 10</HEAD> 11<BODY> 12<H1 align="left">HIO2WriteAsync</H1> 13<H2>C Specification</H2> 14<DL> 15 <DD> 16<PRE><CODE>#include <revolution/hio2.h></CODE></PRE> 17 <DD> 18<PRE><CODE>BOOL HIO2WriteAsync ( HIO2Handle handle, u32 addr, const void* buffer, s32 size, HIO2DmaCallback callback);</CODE></PRE> 19</DL> 20<H2>Arguments</H2> 21<TABLE border="1" cellpadding="3" cellspacing="0.1"> 22 <TBODY> 23 <TR> 24<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>handle</CODE></STRONG></EM> </TD> 25<TD width="520">Handle retrieved using the <CODE>HI02Open</CODE> function.</TD> 26 </TR> 27 <TR> 28<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>addr</CODE></STRONG></EM> </TD> 29<TD width="520">Read address of shared memory for the EXI-USB interface. This address must be 4-byte aligned.</TD> 30 </TR> 31 <TR> 32<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>buffer</CODE></STRONG></EM> </TD> 33<TD width="520">Pointer to the buffer that stores the data to read. This address must be 32-byte aligned.</TD> 34 </TR> 35 <TR> 36<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>size</CODE></STRONG></EM> </TD> 37<TD width="520">Data size to read. Must be a multiple of 32 bytes.</TD> 38 </TR> 39 <TR> 40<TD width="120" bgcolor="#ffffe8"><EM><STRONG><CODE>callback</CODE></STRONG></EM> </TD> 41<TD width="520">Callback function to call when data transfer completes.</TD> 42 </TR> 43 </TBODY> 44</TABLE> 45<H2>Return Values</H2> 46<P>This function returns <CODE>TRUE</CODE> if execution suceeds and <CODE>FALSE</CODE> if execution fails.</P> 47<H2>Description</H2> 48<P>The <CODE>HIO2Write</CODE> function writes the amount of data <EM><STRONG><CODE>size</CODE></STRONG></EM> from the specified <EM><STRONG><CODE>buffer</CODE></STRONG></EM> to the start address <CODE><EM><STRONG>addr</STRONG></EM></CODE> in shared memory. This function returns immediately and does not wait until data transfer finishes. The specified <EM><STRONG><CODE>callback</CODE></STRONG></EM> function is called after all data is read.</P> 49<H2>See Also</H2> 50<CODE><A href="HIO2DmaCallback.html">HIO2DmaCallback</A></CODE><BR> 51<H2>Revision History</H2> 52<P>2006/03/01 Initial version.</P> 53<P>2006/05/29 Added link to HIO2DmaCallback</P> 54<hr> 55<P>CONFIDENTIAL</p> 56</BODY> 57</HTML>