Collapse all Symbian^3 Application Developer Library

Allocation Tutorial

This tutorial describes how to allocate MBufs (for data source components in the Data Plane).

The RMBufChain::Alloc() function allocates the specified amount of memory as a chain of one or several RMBuf objects from the Comms pond. If the pond cannot provide the memory area as a single buffer, the chain contains as many RMBuf s linked together as necessary to fulfil the allocation request.

Create an instance of RMBufChain .
Call RMBufChain::Alloc() . You should use the allocation methods of the parent class ( RCommsBufChain ): see the TLS Look-up Reduction Tutorial . Note: some of the overloaded Alloc() methods specify minimum and maximum values. See Allocation Strategy .
Check the return value for errors. The Alloc() methods return KErrNone if the memory is available as RMBuf in the RMBufChain .
Use the allocated buffer (see Data Access Example ).

Examples

The following example requests 1,800 bytes to the Comms pond. iAllocator is an RMBufAllocator member of the class implementing this example.

       
        
       
       RMBufChain aChain;

TInt err = chain.Alloc(1800, iAllocator);

The following example requests 1,200 bytes and specifies a minimum and a maximum size of 1,600 bytes. If there are no available 1,600-byte buffers in the pond then an error is returned.

       
        
       
       RMBufChain chain;

Tint err = chain.Alloc(1200, 1600, 1600, iAllocator);

Parent topic: Memory Management in the Communications Framework

Related concepts

Overview

Comms Buffers (MBuf) and Comms Chains

Allocation Strategy

Related tasks

TLS Look-up Reduction Tutorial