MAbortDirectScreenAccess Class Reference

#include <w32std.h>

class MAbortDirectScreenAccess
Public Member Functions
pure virtual voidAbortNow(RDirectScreenAccess::TTerminationReasons)

Detailed Description

The interface for terminating direct screen access.

An object of a class which implements this interface should be passed to CDirectScreenAccess::NewL().

See also: MDirectScreenAccess

Member Function Documentation

AbortNow ( RDirectScreenAccess::TTerminationReasons )

voidAbortNow(RDirectScreenAccess::TTerminationReasonsaReason)[pure virtual]

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 AbortNow(), 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
aReasonThe reason why direct screen access was terminated.