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>MPDL API Introduction</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8</HEAD> 9<BODY> 10 11<H1>MPDL API Introduction</H1> 12 13<H2>Introduction</H2> 14<p> 15The MPDL API is a high-level API within the MP library used for download play on the Nintendo DS. Because the MPDL library completely uses the MP library internally for automatic control, it cannot be combined with MP communications for any purpose other than DS download play. 16</p> 17<p> 18For more on the MP library, see the <a href="../mp/intro.html">MP API Introduction</a>. 19</p> 20<H2>Flow of DS Download Play</H2> 21<p>The general flow of DS Download Play is given below. 22<ul> 23<li><strong>Starting the download server (parent)</strong><br>Call the <a href="./MPDLStartup.html">MPDLStartup</a> function to start the MP communication parent.<br>Beacons and MP packets are automatically controlled internally by the MPDL library.</li> 24<li><strong>Managing player entry status</strong><br>The player status of current entries can be checked using the <a href="./MPDLGetEntryBitmap.html">MPDLGetEntryBitmap</a> function. Detailed information for each individual player can be obtained as necessary by using the <a href="./MPDLGetPlayerInfo.html">MPDLGetPlayerInfo</a> function.</li> 25<li><strong>Closing entries and starting the download process</strong><br>When the <a href="./MPDLStartDownload.html">MPDLStartDownload</a> function is called, entries are closed, and the process of downloading to currently entered players starts. New player entries are not generated after this. <br>Although Nintendo DS units are restarted and entries removed for those players whose download has completed, a download may fail (depending on the communication environment) due to a sudden disconnection. Wii applications can confirm the status of players for which the download process has actually completed by waiting until the <a href="./MPDLGetEntryBitmap.html">MPDLGetEntryBitmap</a> function returns zero, then calling the <a href="./MPDLGetBootedBitmap.html">MPDLGetBootedBitmap</a> function. </li> 26<li><strong>If necessary, reconnect with players and execute communications</strong><br>When restarted Nintendo DS applications reconnect to the Wii console, it is necessary to exit the MPDL library using the <a href="./MPDLCleanup.html">MPDLCleanup</a> function, then start application-specific MP communications.<br> (No particular processing is required after processing completes within the downloaded Nintendo DS applications.)</li> 27</ul> 28</p> 29 30<H2>Revision History</H2> 31<P> 322006/08/25 Added a description of the flow of DS download play.<br>2006/07/04 Initial version.<br> 33</P> 34 35<hr><p>CONFIDENTIAL</p></body> 36</HTML> 37