Class RFastLock

class RFastLock : public RSemaphore;

Description

A fast semaphore.

This is a layer over a standard semaphore, and only calls into the kernel side if there is contention.

Derivation

• RHandleBase - A handle to an object.

• RSemaphore - A handle to a semaphore.

• RFastLock - A fast semaphore.

Members

Defined in RFastLock:

• CreateLocal(TOwnerType)Creates a local fast semaphore, and opens this handle to the semaphore.
• RFastLock()Default constructor.
• Signal()Signals the semaphore once.
• Wait()Waits for a signal on the semaphore.

Inherited from RHandleBase:

• Attributes()const
• BTraceId()constReturns a unique object identifier for use with BTrace
• Close()Closes the handle.
• Duplicate(const RThread &,TOwnerType)Creates a valid handle to the kernel object for which the specified thread alrea...
• FullName()constGets the full name of the handle.
• FullName(TDes &)constGets the full name of the handle.
• Handle()constRetrieves the handle-number of the object associated with this handle.
• HandleInfo(THandleInfo *)Gets information about the handle.
• Name()constGets the name of the handle.
• Open(const TFindHandleBase &,TOwnerType)Opens a handle to a kernel side object found using a find-handle object.
• RHandleBase(TInt)Copy constructor.
• SetHandle(TInt)Sets the handle-number of this handle to the specified value.
• SetHandleNC(TInt)Sets the handle-number of this handle to the specified value, and marks it as no...
• SetReturnedHandle(TInt)Sets the handle-number of this handle to the specified value.
• iHandle

Inherited from RSemaphore:

• CreateGlobal(const TDesC &,TInt,TOwnerType)Creates a global semaphore, setting its initial count, and opens this handle to ...
• CreateLocal(TInt,TOwnerType)Creates a semaphore, setting its initial count, and opens this handle to the sem...
• Open(RMessagePtr2,TInt,TOwnerType)Opens a handle to a semaphore using a handle number sent by a client to a server...
• Open(TInt,TOwnerType)Opens a handle to a semaphore using a handle number passed as an environment dat...
• Open(const TFindSemaphore &,TOwnerType)Opens a handle to the global semaphore found using a TFindSemaphore object.
• OpenGlobal(const TDesC &,TOwnerType)Opens a handle to a global semaphore.
• Signal(TInt)Signals the semaphore one or more times.
• Wait(TInt)Waits for a signal on the semaphore, or a timeout.

inline RFastLock();

Description

Default constructor.

IMPORT_C TInt CreateLocal(TOwnerType aType=EOwnerProcess);

Description

Creates a local fast semaphore, and opens this handle to the semaphore.

Parameters

TOwnerType aType An enumeration whose enumerators define the ownership of this semaphore handle. If not explicitly specified, EOwnerProcess is taken as default.

Return value

TInt KErrNone if successful, otherwise one of the system wide error codes.

See also:

• RSemaphore::CreateLocal(TInt,TOwnerType)Creates a semaphore, setting its initial count, and opens this handle to the sem...

IMPORT_C void Wait();

Description

Waits for a signal on the semaphore.

The function decrements the semaphore count by one and returns immediately if it is zero or positive.

If the semaphore count is negative after being decremented, the calling thread is added to a queue of threads maintained by this semaphore.

The thread waits until the semaphore is signalled. More than one thread can be waiting on a particular semaphore at a time. When there are multiple threads waiting on a semaphore, they are released in priority order.

If the semaphore is deleted, all threads waiting on that semaphore are released.

IMPORT_C void Signal();

Description

Signals the semaphore once.

The function increments the semaphore count by one. If the count was negative before being incremented, the highest priority thread waiting on the semaphore's queue of threads is removed from that queue and, provided that it is not suspended for any other reason, is marked as ready to run.