Collapse all Symbian^3 Product Developer Library

TChunkHeapCreateInfo Struct Reference

struct TChunkHeapCreateInfo

This structure specifies the type and properties of the user heap to be created. It is passed as a parameter to the UserHeap::Create() method.

Public Member Functions
	TChunkHeapCreateInfo(TInt, TInt)
void	SetAlignment(TInt)
IMPORT_C void	SetCreateChunk(const TDesC *)
void	SetGrowBy(TInt)
void	SetMode(TUint)
void	SetOffset(TInt)
void	SetPaging(const TChunkHeapPagingAtt)
void	SetSingleThread(TBool)
IMPORT_C void	SetUseChunk(const RChunk)

Public Member Enumerations
enum	TChunkHeapCreateVersions { EVersion0, ESupportedVersions }
enum	TChunkHeapPagingAtt { EUnspecified, EPaged, EUnpaged }

Protected Attributes
TInt	iAlign
RChunk	iChunk
TInt	iGrowBy
TInt	iMaxLength
TInt	iMinLength
TUint	iMode
TDesC *	iName
TInt	iOffset
TChunkHeapPagingAtt	iPaging
TBool	iSingleThread
TInt	iSpare
TUint	iVersionNumber

Constructor & Destructor Documentation

TChunkHeapCreateInfo(TInt, TInt)

IMPORT_C	TChunkHeapCreateInfo	(	TInt	aMinLength,
			TInt	aMaxLength
		)

Constructor where minimum and maximum length of the heap can be defined. It defaults the chunk heap to be created to have use a new local chunk, to have a grow by value of KMinHeapGrowBy, to be unaligned, not to be single threaded and not to have any mode flags set.

Parameters

TInt aMinLength	The minimum length of the heap to be created.
TInt aMaxLength	The maximum length to which the heap to be created can grow. If the supplied value is less than KMinHeapSize, then it is discarded and the value KMinHeapSize used instead.

Member Functions Documentation

SetAlignment(TInt)

void

SetAlignment

(

TInt

aAlign

)

[inline]

Sets alignment of the cells of the chunk heap to be created.

This overrides any previous call to TChunkHeapCreateInfo::SetAlignment() for this TChunkHeapCreateInfo object.

Parameters

TInt aAlign

SetCreateChunk(const TDesC *)

IMPORT_C void

SetCreateChunk

(

const TDesC *

aName

)

Sets the chunk heap to create a new chunk with the specified name.

This overriddes any previous call to TChunkHeapCreateInfo::SetNewChunkHeap() or TChunkHeapCreateInfo::SetExistingChunkHeap() for this TChunkHeapCreateInfo object.

Parameters

const TDesC * aName

The name to be given to the chunk heap to be created If NULL, the function constructs a local chunk to host the heap. If not NULL, a pointer to a descriptor containing the name to be assigned to the global chunk hosting the heap.

SetGrowBy(TInt)

void

SetGrowBy

(

TInt

aGrowBy

)

[inline]

Sets the increments to the size of the host chunk. If the supplied value is less than KMinHeapGrowBy, it is discarded and the value KMinHeapGrowBy is used instead.

This overrides any previous call to TChunkHeapCreateInfo::SetGrowBy() for this TChunkHeapCreateInfo object.

Parameters

TInt aGrowBy

The increment to the size of the host chunk.

SetMode(TUint)

void

SetMode

(

TUint

aMode

)

[inline]

Sets the mode flags of the chunk heap.

This overrides any previous call to TChunkHeapCreateInfo::SetMode() for this TChunkHeapCreateInfo object.

Parameters

TUint aMode

The mode flags for the chunk heap to be created, this should be one or more of the values from TChunkHeapCreateMode.

SetOffset(TInt)

void

SetOffset

(

TInt

aOffset

)

[inline]

Sets the offset from the base of the host chunk to the start of the heap.

This overrides any previous call to TChunkHeapCreateInfo::SetOffset() for this TChunkHeapCreateInfo object.

Parameters

TInt aOffset

The offset in bytes.

SetPaging(const TChunkHeapPagingAtt)

void

SetPaging

(

const TChunkHeapPagingAtt

aPaging

)

[inline]

Sets the paging attribute of the chunk heap to be created.

This overrides any previous call to TChunkHeapCreateInfo::SetPaging() for this TChunkHeapCreateInfo object.

Parameters

const TChunkHeapPagingAtt aPaging

The paging attribute for the chunk heap to be created.

SetSingleThread(TBool)

void

SetSingleThread

(

TBool

aSingleThread

)

[inline]

Sets single thread property of the chunk heap.

This overrides any previous call to TChunkHeapCreateInfo::SetSingleThread() for this TChunkHeapCreateInfo object.

Parameters

TBool aSingleThread

ETrue when the chunk heap is to be single threaded, EFalse otherwise.

SetUseChunk(const RChunk)

IMPORT_C void

SetUseChunk

(

const RChunk

aChunk

)

Sets the chunk heap to be created to use the chunk specified.

This overriddes any previous call to TChunkHeapCreateInfo::SetNewChunkHeap() or TChunkHeapCreateInfo::SetExistingChunkHeap() for this TChunkHeapCreateInfo object.

Parameters

const RChunk aChunk

A handle to the chunk to use for the heap.

Member Enumerations Documentation

Enum TChunkHeapCreateVersions

Currently supported version numbers

Enumerators

EVersion0
ESupportedVersions

Enum TChunkHeapPagingAtt

Attributes that specify whether the chunk heap to be created is data paged or not.

Enumerators

EUnspecified	The chunk heap will use the creating process's paging attributes.
EPaged	The chunk heap will be data paged.
EUnpaged	The chunk heap will not be data paged.

Member Data Documentation

TInt iAlign

TInt

iAlign

[protected]

The alignment of the heap.

RChunk iChunk

RChunk

iChunk

[protected]

The chunk to use for the heap.

TInt iGrowBy

TInt

iGrowBy

[protected]

The grow by value of the heap.

TInt iMaxLength

TInt

iMaxLength

[protected]

The maximum size for the heap.

TInt iMinLength

TInt

iMinLength

[protected]

The minimum size for the heap.

TUint iMode

TUint

iMode

[protected]

The mode flags for the heap.

TDesC * iName

TDesC *

iName

[protected]

The name of the chunk to be created for the heap.

TInt iOffset

TInt

iOffset

[protected]

The offset from the base of the chunk to the start of the heap.

TChunkHeapPagingAtt iPaging

TChunkHeapPagingAtt

iPaging

[protected]

The paging attributes of the chunk.

TBool iSingleThread

TBool

iSingleThread

[protected]

The single thread value of the heap.

TInt iSpare

TInt

iSpare

[protected]

TUint iVersionNumber

TUint

iVersionNumber

[protected]

The version number of this TChunkHeapCreateInfo.