Class TStreamExchange

class TStreamExchange;

Description

Manages access to a shared host buffer for shared stream buffers.

The class maintains independent markers for the shared stream buffer that has most recently read or written to the shared host buffer.

This is the way in which multiple requests from the same shared stream buffer are handled without the need for repeated seeking. The shared host buffer only needs to seek when a new shared buffer needs to use it

Members

Defined in TStreamExchange:

• Host()Gets a pointer to the stream buffer that acts as the shared host.
• HostL()Gets a pointer to the stream buffer that acts as the shared host, and leaves if ...
• IsActive()constTests whether this object is using a stream buffer that is acting as shared host...
• Release()Releases the reference to the shared host, and drops any active read or write ma...
• Share(MStreamBuf *)Tells the object to use the specified stream buffer that will act as the shared ...
• SizeL()constGets the size of the shared host buffer.
• TStreamExchange()Constructs an empty object.
• TStreamExchange(MStreamBuf *)Constructs the object, specifying the stream buffer that will act as the shared ...

inline TStreamExchange();

Description

Constructs an empty object.

Call TStreamExchange::Share(MStreamBuf *) to prepare for access to a shared stream buffer.

inline TStreamExchange(MStreamBuf *aHost);

Description

Constructs the object, specifying the stream buffer that will act as the shared host.

Parameters

inline void Share(MStreamBuf *aHost);

Description

Tells the object to use the specified stream buffer that will act as the shared host.

Parameters

inline TBool IsActive() const;

Description

Tests whether this object is using a stream buffer that is acting as shared host.

Return value

IMPORT_C MStreamBuf* Host();

Description

Gets a pointer to the stream buffer that acts as the shared host.

The function refreshes the active read/write marks and gives the caller exclusive use of the shared host.

Return value

IMPORT_C MStreamBuf* HostL();

Description

Gets a pointer to the stream buffer that acts as the shared host, and leaves if this object is not active.

The function refreshes the active read/write marks and gives the caller exclusive use of the shared host.

Return value

See also:

• TStreamExchange::IsActive()constTests whether this object is using a stream buffer that is acting as shared host...

IMPORT_C void Release();

Description

Releases the reference to the shared host, and drops any active read or write marks.

IMPORT_C TInt SizeL() const;

Description

Gets the size of the shared host buffer.

Return value