vxwsm.html

vxworks相关论文

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VXWSmMsgQ
    (
    int maxMsgs,
    int maxMsgLength,
    int options
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine creates a shared memory message queue capable of holding up
to <i>maxMsgs</i> messages, each up to <i>maxMsgLength</i> bytes long.  The queue
can only be created with the option <b>MSG_Q_FIFO</b> (0), thus queuing pended
tasks in FIFO order.
<p>
If there is insufficient memory to store the message queue structure
in the shared memory message queue partition or if the shared memory system
pool cannot handle the requested message queue size, shared memory message 
queue creation fails with <b>errno</b> set to S_smMemLib_NOT_ENOUGH_MEMORY.
This problem can be solved by incrementing the <b>SM_OBJ_MAX_MSG_Q</b> value
in <b>configAll.h</b> and/or the size of memory dedicated to shared-memory objects
<b>SM_OBJ_MEM_SIZE</b> in <b>config.h</b>.
<p>
</blockquote><h4>AVAILABILITY</h4><blockquote><p>
<p>
This routine depends on code distributed as a component of the unbundled
shared memory objects support option, VxMP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
<p>
&nbsp;S_smMemLib_NOT_ENOUGH_MEMORY<br>
&nbsp;S_intLib_NOT_ISR_CALLABLE<br>
&nbsp;S_msgQLib_INVALID_QUEUE_TYPE<br>
&nbsp;S_smObjLib_LOCK_TIMEOUT
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWSm.html#top">VXWSm</a></b>, <b>vxwMsgQLib</b>, <b>vxwSmNameLib</b>

<hr>
<a name="VXWSmMemPart::VXWSmMemPart"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWSmMemPart::VXWSmMemPart</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWSmMemPart::VXWSmMemPart</i>(&nbsp;)</strong> - create a shared memory partition (VxMP Option)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VXWSmMemPart
    (
    char *   pool,
    unsigned poolSize
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine creates a shared memory partition that can be used by tasks
on all CPUs in the system to manage memory blocks .  Because the
<b>VXWSmMemPart</b> class inherits from <b><a href="./VXWMemPart.html#top">VXWMemPart</a></b>, you can use the
general-purpose methods in that class to manage the partition (that
is, to allocate and free memory blocks in the partition).
<p>
<i>pool</i> is a pointer to the global address of shared memory dedicated to the
partition.  The memory area where <i>pool</i> points must be in the same
address space as the shared memory anchor and shared memory pool.
<p>
<i>poolSize</i> is the size in bytes of shared memory dedicated to the partition.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
The descriptor for the new partition is allocated out of an internal
dedicated shared memory partition.  The maximum number of partitions that can
be created is <b>SM_OBJ_MAX_MEM_PART</b>, defined in <b>configAll.h</b>.
<p>
Memory pool size is rounded down to a 16-byte boundary.
<p>
</blockquote><h4>AVAILABILITY</h4><blockquote><p>
This routine depends on code distributed as a component of the unbundled
shared memory objects support option, VxMP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
<p>
&nbsp;S_memLib_NOT_ENOUGH_MEMORY<br>
&nbsp;S_smObjLib_LOCK_TIMEOUT&nbsp;
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWSm.html#top">VXWSm</a></b>, <b>vxwMemPartLib</b>, <b>vxwSmNameLib</b>

<hr>
<a name="VXWSmMemBlock::VXWSmMemBlock"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWSmMemBlock::VXWSmMemBlock</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWSmMemBlock::VXWSmMemBlock</i>(&nbsp;)</strong> - allocate a block of memory from the shared memory system partition (VxMP Option)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VXWSmMemBlock
    (
    int nBytes
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine allocates, from the shared memory system partition, a
block of memory whose size is equal to or greater than <i>nBytes</i>.
The local address of the allocated shared memory block can be
obtained from <b><i><a href="./VXWSm.html#VXWSmMemBlock::baseAddress">VXWSmMemBlock::baseAddress</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>AVAILABILITY</h4><blockquote><p>
This routine depends on code distributed as a component of the unbundled
shared memory objects support option, VxMP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
<p>
&nbsp;S_memLib_NOT_ENOUGH_MEMORY<br>
&nbsp;S_smObjLib_LOCK_TIMEOUT
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWSm.html#top">VXWSm</a></b>

<hr>
<a name="VXWSmMemBlock::VXWSmMemBlock_1"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWSmMemBlock::VXWSmMemBlock</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWSmMemBlock::VXWSmMemBlock</i>(&nbsp;)</strong> - allocate memory for an array from the shared memory system partition (VxMP Option)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>VXWSmMemBlock
    (
    int nElems,
    int sizeOfElem
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine allocates a block of memory for an array that contains
<i>nElems</i> elements of size <i>sizeOfElem</i> from the shared memory system 
partition.
The local address of the allocated shared memory block can be
obtained from <b><i><a href="./VXWSm.html#VXWSmMemBlock::baseAddress">VXWSmMemBlock::baseAddress</a></i>(&nbsp;)</b>.
<p>
</blockquote><h4>AVAILABILITY</h4><blockquote><p>
This routine depends on code distributed as a component of the unbundled
shared memory objects support option, VxMP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
<p>
A pointer to the block, or NULL if the memory cannot be allocated.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
<p>
&nbsp;S_memLib_NOT_ENOUGH_MEMORY<br>
&nbsp;S_smObjLib_LOCK_TIMEOUT
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWSm.html#top">VXWSm</a></b>

<hr>
<a name="VXWSmMemBlock::~VXWSmMemBlock"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWSmMemBlock::~VXWSmMemBlock</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWSmMemBlock::~VXWSmMemBlock</i>(&nbsp;)</strong> - free a shared memory system partition block of memory (VxMP Option)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    virtual ~VXWSmMemBlock ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine returns a <b>VXWSmMemBlock</b> shared-memory block to the
free-memory pool in the shared-memory system partition.
<p>
</blockquote><h4>AVAILABILITY</h4><blockquote><p>
This routine depends on code distributed as a component of the unbundled shared memory
objects support option, VxMP.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
<p>
&nbsp;S_smObjLib_LOCK_TIMEOUT
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./VXWSm.html#VXWSmMemBlock::VXWSmMemBlock">VXWSmMemBlock::VXWSmMemBlock</a></i>(&nbsp;)</b>

<hr>
<a name="VXWSmMemBlock::baseAddress"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWSmMemBlock::baseAddress</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWSmMemBlock::baseAddress</i>(&nbsp;)</strong> - address of shared-memory block</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    void * baseAddress ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine reports the local address of a block of shared memory
managed as a <b>VXWSmMemBlock</b> object.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
Local address of memory block in shared-memory system partition.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWSm.html#top">VXWSm</a></b>

</body>
</html>