diff -r 613943a21004 -r 9386f31cc85b bluetoothengine/btnotif/inc/btnotifactive.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/bluetoothengine/btnotif/inc/btnotifactive.h Wed Sep 01 12:20:04 2010 +0100 @@ -0,0 +1,191 @@ +/* +* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Declares active object helper class. +* +*/ + +#ifndef BTNOTIFACTIVE_H +#define BTNOTIFACTIVE_H + + +#include + +class CBTNotifActive; + +/** + * Class MBTNotifActiveObserver + * + * Callback class for receiving a completed active object event. + * Users of CBTEngActive need to derive from this class. + */ +class MBTNotifActiveObserver + { + +public: + + /** + * Callback to notify that an outstanding request has completed. + * + * @since S60 5.1 + * @param aActive Pointer to the active object that completed. + * @param aId The ID that identifies the outstanding request. + * @param aStatus The status of the completed request. + */ + virtual void RequestCompletedL( CBTNotifActive* aActive, TInt aId, + TInt aStatus ) = 0; + + /** + * Callback to notify that an error has occurred in RunL. + * + * @param aActive Pointer to the active object that had error. + * @param aId The ID that identifies the outstanding request. + * @param aStatus The status of the completed request. + */ + virtual void HandleError( CBTNotifActive* aActive, TInt aId, + TInt aError ) = 0; + + /** + * Callback to notify that request is canceled. + * Active object may add specified steps here. + * + * @param aActive Pointer to the active object that is canceled. + * @param aId The ID that identifies the outstanding request. + */ + virtual void DoCancelRequest( CBTNotifActive* aActive, TInt aId ) = 0; + }; +/** + * Class CBTNotifActive + */ +NONSHARABLE_CLASS( CBTNotifActive ) : public CActive + { + +public: + /** + * Two-phased constructor. + * @param aObserver Pointer to callback interface that receives notification + * that the request has been completed. + * @param aId Request ID to identify which request is completed. + * @return Pointer to the constructed CBTNotifActive object. + */ + static CBTNotifActive* NewL( MBTNotifActiveObserver* aObserver, TInt aId, TInt aPriority ); + + /** + * Destructor. + */ + virtual ~CBTNotifActive(); + + /** + * Get the request ID of this active object. + * + * @since S60 v5.1 + * @return The request ID of this active object. + */ + inline TInt RequestId(); + + /** + * Set a new request ID for this active object. + * + * @since S60 v5.1 + * @param The new request ID of this active object. + */ + inline void SetRequestId( TInt aId ); + + /** + * Activate the active object. + * + * @since S60 v5.1 + */ + inline void GoActive(); + + /** + * Cancel an outstanding request. + * + * @since S60 v5.1 + */ + inline void CancelRequest(); + + /** + * Get a reference to the active object request status. + * + * @since S60 v5.1 + * @return Reference to the active object request status. + */ + TRequestStatus& RequestStatus(); + +// from base class CActive + + /** + * From CActive. + * Called by the active scheduler when the request has been cancelled. + * + * @since S60 v5.1 + */ + void DoCancel(); + + /** + * From CActive. + * Called by the active scheduler when the request has been completed. + * + * @since S60 v5.1 + */ + void RunL(); + + /** + * From CActive. + * Called by the active scheduler when an error in RunL has occurred. + * + * @since S60 v5.1 + */ + TInt RunError( TInt aError ); + +private: + + /** + * C++ default constructor + * + * @since S60 v5.1 + * @param aObserver Pointer to callback interface that receives notification + * that the request has been completed. + * @param aId ID of the request (for the client to keep track of multiple + * active objects). + * @param aPriority Priority of + */ + CBTNotifActive( MBTNotifActiveObserver* aObserver, TInt aId, TInt aPriority ); + + /** + * Symbian 2nd-phase constructor + * + * @since S60 v5.1 + */ + void ConstructL(); + +private: // data + + /** + * ID of the request (used only by our client). + */ + TInt iRequestId; + + /** + * Our observer. + * Not own. + */ + MBTNotifActiveObserver* iObserver; + + }; + +#include "btnotifactive.inl" + + +#endif // BTNOTIFACTIVE_H