Constructor for performing 1st stage construction

Destructor.

Acquires read buffer for stream. For > 1 buffer streams this function doesn't block, but simply returns WFC_INVALID_HANDLE if no buffer is available for reading. For 1 buffer stream the caller is blocked until the buffer is ready for reading (the reader has committed the buffer, that is.)

An example sequence for 3 buffer stream where producer produces frames approx. after every ~5th time unit. Consumer consumes buffers at constant rate of 1buf/time unit. Pframe is the number/handle of buffer that is being written by the producer (let's assume that it takes 2 time units for producer to produce a frame/buffer.) Cframe is the number/ handle of the buffer the consumer receives from AcquireReadBuffer(). "i" stands for WFC_INVALID_HANDLE:

Time: 0 5 10 15 20 25 Pframe: 0 1 2 0 1 ... Cframe: ii00000111112222200000111...

An example sequence for 3 buffer stream where producer produces frames approx. after every ~5th time unit. Consumer consumes buffers at constant rate of 1buf/time unit. Pframe is the number/handle of buffer that is being written by the producer (let's assume that it takes 2 time units for producer to produce a frame/buffer.) Cframe is the number/ handle of the buffer the consumer receives from AcquireReadBuffer(). "i" stands for WFC_INVALID_HANDLE:

 Time:   0    5    10   15   20   25
 Pframe: 0    1    2    0    1    ...
 Cframe: ii00000111112222200000111...

Acquires write buffer for stream.

Returns handle to a buffer that can be used to write data into stream. If no clean buffer is available, invalid handle is returned.

Returns handle to a buffer that can be used to write data into stream. If no clean buffer is available, invalid handle is returned.

Add event observer for stream. Observers are served in first-come-first-serve fashion. That is, newest observer is always placed at the end of the chain. If the observer is already in the chain, it's popped out and moved to the end of the chain.

Add event observer for stream. Observers are served in first-come-first-serve fashion. That is, newest observer is always placed at the end of the chain.

Increase stream's reference count by one.

Processes the available observer

A helper function that returns the bytes per pixel for a given pixel format UID

Cancels all active notifications by completeting the associated requests

A function that checks the validity of the new buffer provided by SUS

When the contents of a surface change, this function gets called by the MCompositionSurfaceUpdate implementation. If the buffer is invalid all request statuses will be completed with KErrArgument

Symbian's default constructor for performing 2nd stage construction

Processes the available observer

Processes the available observer

Notifies the composer that process of updating the content has finisshed

The composer releases the content mutex and triggers a new composition

Helper to resolve handle to stream object

Returns pointer to pixel buffer.

Get stream "frame header". Can be used to query all or some of the frame properties.

Passing a NULL pointer implies that particular value is of no interest to caller. E.g. GetHeader(stream, &w, &h, NULL, NULL, NULL); would only fetch width & height parameters.

Passing a NULL pointer implies that particular value is of no interest to caller. E.g. owfNativeStreamGetHeader(stream, &w, &h, NULL, NULL, NULL); would only fetch width & height parameters.

Two-phased constructor.

Two-phased constructor.

Notifies the composer that the content has been updated.

Notifies the observers not associated with a context. The aim is to support legacy SI behavior.

Process the notifications by accessing the information stored in the observer container.

This method is expected to be called from the observer context every time composer has finished processing a stream and the rigger condition is met.

Releases read buffer.

When read buffer is released, it is marked as clean to be written again, unless it is the only committed buffer in which case it is recycled so that the same buffer can be read again (as long as no new buffers are committed by the producer)

When read buffer is released, it is marked as clean to be written again, unless it is the only committed buffer in which case it is recycled so that the same buffer can be read again (as long as no new buffers are committed by the producer)

Decrease stream's reference count by one and destroy the stream, if the reference count goes to zero.

All acquired read & write buffers must be released before calling WFC_Native_Destroy.

All acquired read & write buffers must be released before calling WFC_Native_Destroy.

Releases write buffer to stream. Released buffer is made new front buffer, i.e., producer is expected to release buffer is the same order they were acquired.

internal

Remove stream event observer. Observer is removed from the stream's event nofitication chain and won't receive any events from the stream afterwards.

Remove stream event observer. Observer is removed from the stream's event nofitication chain and won't receive any events from the stream afterwards.

Function used to reset observer data fields

Implements surface content notifications.

When the contents of a surface change, this function gets called MCompositionSurfaceUpdate implementation.

internal

Sets flipped state.

Implements surface content notifications.

When the contents of a surface change, this function gets called MCompositionSurfaceUpdate implementation.

Undocumented protection flag

Notifies the composer that the content is in process to be updated. The composer will have to not access observer related information

Note that while calling the callback the context update mutex is acquired.

Returns internal surface ID.

Helper to resolve handle to stream object

Notifies the composer that content has been updated

It is used to support old SI behaviour. The content update mutex is acuired and released while a new composition is triggered