Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <W32STD.H>

Class MAbortDirectScreenAccess

class MAbortDirectScreenAccess;

Description

The interface for terminating direct screen access.

An object of a class which implements this interface should be passed to CDirectScreenAccess::NewL(RWsSession &,CWsScreenDevice &,RWindowBase &,MDirectScreenAccess &).

See also:


Member functions


AbortNow(RDirectScreenAccess::TTerminationReasons)

virtual void AbortNow(RDirectScreenAccess::TTerminationReasons aReason)=0;

Description

This function is called by the window server when direct screen access must stop (for example because a dialogue is moved in front of the area where direct screen access is taking place).

In response to this, direct screen access must stop immediately. In simple cases, this will involve cancelling the active object that is driving the drawing to the screen.

No attempt to call a Window Server API function can be made from MAbortDirectScreenAccess::AbortNow(RDirectScreenAccess::TTerminationReasons), because then a temporary deadlock will occur. This is because WSERV is waiting to receive the client's acknowledgment that it has aborted, and so will not be able to service the call. As soon as the restriction no longer applies, the function Restart() will be called.

Parameters

RDirectScreenAccess::TTerminationReasons aReason

The reason why direct screen access was terminated.