1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3 4<head> 5<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 6<META name="GENERATOR" content="Microsoft FrontPage 5.0"> 7<META http-equiv="Content-Style-Type" content="text/css"> 8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css"> 9<title>OSInitMessageQueue</title> 10</head> 11 12<body> 13 14<h1>OSInitMessageQueue</h1> 15 16<h2>Syntax</h2> 17<dl><dd><pre class="construction"> 18#include <revolution/os.h> 19 20void OSInitMessageQueue( 21 OSMessageQueue* mq, 22 OSMessage* msgArray, 23 s32 msgCount); 24</pre></dd></dl> 25 26<h2>Arguments</h2> 27<TABLE class="arguments" border="1" > 28 <tr> 29<TH><STRONG><EM><CODE>mq</CODE></EM></STRONG></TH> 30<TD>Pointer to message queue.</TD> 31 </tr> 32 <tr> 33<TH><STRONG><EM><CODE>msgArray</CODE></EM></STRONG></TH> 34<TD>Pointer to array that will hold the messages.</TD> 35 </tr> 36 <tr> 37<TH><STRONG><EM><CODE>msgCount</CODE></EM></STRONG></TH> 38<TD>The number of messages that the array can hold.</TD> 39 </tr> 40</TABLE> 41 42<h2>Return Values</h2> 43<p>None.</p> 44 45<h2>Description</h2> 46<p>Initializes the message queue structure <SPAN class="argument">mq</SPAN>. The <SPAN class="argument">msgArray</SPAN> argument is a pointer to the array that maintains messages for this queue, and the <SPAN class="argument">msgCount</SPAN> argument is the number of messages that can be maintained in the queue (in other words, the array size).</p> 47 48<h2>See Also</h2> 49<P class="reference"> 50<A href="../toc.html#Thread" target="contents">Thread Functions</A>, 51<A href="../toc.html#ThreadSynchronization" target="contents">Thread Synchronization Functions</A>, 52<a href="OSJamMessage.html">OSJamMessage</a>, 53<a href="OSReceiveMessage.html">OSReceiveMessage</a>, 54<a href="OSSendMessage.html">OSSendMessage</a> 55</p> 56 57<h2>Revision History</h2> 58<P> 592006/03/01 Initial version.<br> 60</p> 61 62<hr><p>CONFIDENTIAL</p></body> 63</html>