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>MPDS API Introduction</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../CSS/revolution.css"> 8</HEAD> 9<BODY> 10 11<H1>MPDS API Introduction</H1> 12 13<H2>Introduction</H2> 14<p> 15The MPDS library is a DataSharing protocol library that allows data to be shared synchronously at the game frame level via MP communications between parent and child devices. 16</p> 17<p> 18The MPDS library uses any one communications port of the MP library. All other communications ports, as well as overall control of MP communications, can be freely managed on the application side.<BR> The corresponding implementation on the client side is included in the WM library in the Nintendo DS development kit, NITRO-SDK. For details, see the Wireless Communications Library Overview included with the NITRO-SDK. 19</p> 20<p> 21For more on the MP library, see the <a href="../mp/intro.html">MP API Introduction</a>. 22</p> 23 24<H2>Differences with the DS</H2> 25<p> 26The MP communications cycle among DS devices will not match the Wii V-Blank cycle because the Wii and the DS have different V-Blank cycles. So to perform DataSharing seamlessly, a dedicated thread that works on the MP communication cycle (the one that succeeds for the <a href="MPDSStep.html"><code>MPDSStep</code></a> function) is needed in addition to the main loop for rendering that matches the Wii V-Blank cycle. 27</p> 28<p> 29You can also perform DataSharing within the main loop without creating a thread by using the <a href="MPDSStep.html"><code>MPDSTryStep</code></a> function, but DataSharing will fail frequently because the timing at which data is set does not match between the parent and the child. 30</p> 31<p> 32There is a third way, as well. Using the callback function that can be configured in the <a href="MPDSConfig.html"><code>MPDSConfig</code></a> structure's <CODE>mpdsCallback</CODE> field, you can call the <a href="MPDSStep.html"><code>MPDSTryStep</code></a> function within the shared data delivery notification callback. Take care to avoid excessive processing within the callback function, though. 33</p> 34 35<H2>Revision History</H2> 36<P> 372007/11/28 Initial version. 38</P> 39 40<hr><p>CONFIDENTIAL</p></body> 41</HTML> 42