Collapse all Symbian^3 Product Developer Library

TThreadCreateInfo Struct Reference

struct TThreadCreateInfo

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

Public Member Functions
	TThreadCreateInfo(const TDesC &, TThreadFunction, TInt, TAny *)
IMPORT_C void	SetCreateHeap(TInt, TInt)
IMPORT_C void	SetOwner(const TOwnerType)
IMPORT_C void	SetPaging(const TThreadPagingAtt)
IMPORT_C void	SetUseHeap(const RAllocator *)

Public Member Enumerations
enum	TThreadCreateVersions { EVersion0, ESupportedVersions }
enum	TThreadPagingAtt { EUnspecified, EPaged, EUnpaged }

Protected Attributes
TUint	iAttributes
TThreadFunction	iFunction
RAllocator *	iHeap
TInt	iHeapMaxSize
TInt	iHeapMinSize
const TDesC *	iName
TOwnerType	iOwner
TAny *	iParameter
TUint32	iSpare
TInt	iStackSize
TUint	iVersionNumber

Constructor & Destructor Documentation

TThreadCreateInfo(const TDesC &, TThreadFunction, TInt, TAny *)

IMPORT_C	TThreadCreateInfo	(	const TDesC &	aName,
			TThreadFunction	aFunction,
			TInt	aStackSize,
			TAny *	aPtr
		)

Constructor where the basic properties of the thread to be created are specified.

NOTE - TThreadCreateInfo::SetCreateHeap() or TThreadCreateInfo::SetUseHeap() must be invoked on this TThreadCreateInfo to set the type of the thread to be created before being passed as a paramter to RThread::Create().

Parameters

const TDesC & aName	The name to be assigned to the thread. KNullDesC, to create an anonymous thread.
TThreadFunction aFunction	A pointer to a function. Control passes to this function when the thread is first resumed, i.e. when the thread is initially scheduled to run.
TInt aStackSize	The size of the new thread's stack. This must be at least 512 bytes, otherwise RThread::Create() will fail with KErrArgument.
TAny * aPtr	A pointer to data to be passed as a parameter to the thread function when the thread is initially scheduled to run. If the thread function does not need any data then this pointer can be NULL.

Member Functions Documentation

SetCreateHeap(TInt, TInt)

IMPORT_C void	SetCreateHeap	(	TInt	aHeapMinSize,
			TInt	aHeapMaxSize
		)

Sets the thread to be created to create its own heap.

Parameters

TInt aHeapMinSize	The minimum size for the new thread's heap.
TInt aHeapMaxSize	The maximum size for the new thread's heap.

SetOwner(const TOwnerType)

IMPORT_C void

SetOwner

(

const TOwnerType

aOwner

)

Sets the owner the thread to be created. Any previous calls to this method will be overridden for this TThreadCreateInfo object.

Parameters

const TOwnerType aOwner

The owner of the thread to be created.

SetPaging(const TThreadPagingAtt)

IMPORT_C void

SetPaging

(

const TThreadPagingAtt

aPaging

)

Sets the data paging attributes of the thread to be created. Any previous calls to this method will be overridden for this TThreadCreateInfo object.

Parameters

const TThreadPagingAtt aPaging

The paging attributes for the thread to be created.

SetUseHeap(const RAllocator *)

IMPORT_C void

SetUseHeap

(

const RAllocator *

aHeap

)

Sets the thread to be created to use the heap whose handle is pointed to by aAllocator. If this is NULL, then the thread uses the heap of the creating thread.

Parameters

const RAllocator * aHeap

A pointer to the handle of the heap belonging to another thread which this thread is to use.

Member Enumerations Documentation

Enum TThreadCreateVersions

Currently supported version numbers

Enumerators

EVersion0
ESupportedVersions

Enum TThreadPagingAtt

Attributes that specify whether the stack and heap of the thread to be created are data paged or not.

Enumerators

EUnspecified	The thread will use the creating process's paging attributes.
EPaged	The thread will data page its stack and heap.
EUnpaged	The thread will not data page its stack and heap.

Member Data Documentation

TUint iAttributes

TUint

iAttributes

[protected]

The attributes of the thread

TThreadFunction iFunction

TThreadFunction

iFunction

[protected]

The function this thread will execute.

RAllocator * iHeap

RAllocator *

iHeap

[protected]

The heap for the thread to be created to use. NULL if a new heap is to be created.

TInt iHeapMaxSize

TInt

iHeapMaxSize

[protected]

Maximum size of any heap to be created for the thread.

TInt iHeapMinSize

TInt

iHeapMinSize

[protected]

Minimum size of any heap to be created for the thread.

const TDesC * iName

const TDesC *

iName

[protected]

The Name to be given to the thread to be created

TOwnerType iOwner

TOwnerType

iOwner

[protected]

The owner of the thread to be created.

TAny * iParameter

TAny *

iParameter

[protected]

The parameter to be passed to the function of the thread to be created.

TUint32 iSpare

TUint32

iSpare

[protected]

TInt iStackSize

TInt

iStackSize

[protected]

The size of the stack of the thread to be created.

TUint iVersionNumber

TUint

iVersionNumber

[protected]

The version number of this TChunkCreateInfo.