diff -r 6369bfd1b60d -r 08b5eae9f9ff upnpmpxplugins/upnpplaybackplugins/inc/upnpmusicperiodizer.h --- a/upnpmpxplugins/upnpplaybackplugins/inc/upnpmusicperiodizer.h Mon Nov 01 13:44:24 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,171 +0,0 @@ -/* -* Copyright (c) 2008 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: Periodic timer support resource -* -*/ - - - - - - -#ifndef __UPNPMUSICPERIODIZER_H__ -#define __UPNPMUSICPERIODIZER_H__ - -// INCLUDES -#include -#include "upnpmusicperiodizer.h" - -// FORWARD DECLARATIONS -class MUPnPMusicPeriodizerObserver; - -/** - * A class that provides periodic notifications. - * - * Once started, notifies an abstract interface periodically - * but only when Continue is called. This avoids situation - * where previous operation is still in progress when the next - * notification arrives. - * - * @lib upnpmusicplugins.lib - * @since S60 v3.1 - */ -class CUPnPMusicPeriodizer : public CTimer - { - -public: - - /** - * Static constructor - * - * @since Series 60 3.1 - * @param aObserver the party to be notified on timer trigger - * @param aTimerWavelength the timer delay in microseconds - */ - static CUPnPMusicPeriodizer* NewL( - MUPnPMusicPeriodizerObserver& aObserver, - TInt32 aTimerWavelength ); - - /** - * Static constructor - * - * @since Series 60 3.1 - * @param aObserver the party to be notified on timer trigger - * @param aTimerWavelength the timer delay in microseconds - */ - static CUPnPMusicPeriodizer* NewLC( - MUPnPMusicPeriodizerObserver& aObserver, - TInt32 aTimerWavelength ); - - /** - * Destructor - * - * @since Series 60 3.1 - */ - virtual ~CUPnPMusicPeriodizer(); - -private: - - /** - * Constructor - * - * @since Series 60 3.1 - * @param aObserver the party to be notified on timer trigger - * @param aTimerWavelength the timer delay in microseconds - */ - CUPnPMusicPeriodizer( - MUPnPMusicPeriodizerObserver& aObserver, - TInt32 aTimerWavelength ); - - /** - * 2nd phase constructor - * - * @since Series 60 3.1 - */ - void ConstructL(); - -public: - - /** - * Starts the periodizer - * - * @since Series 60 3.1 - */ - void Start(); - - /** - * Continues a next step for the periodizer - * - * @since Series 60 3.1 - */ - void Continue(); - - /** - * Stops periodizer - * - * @since Series 60 3.1 - */ - void Stop(); - -protected: // personal method - - /** - * Receives the timer triggering - * - * @since Series 60 3.1 - */ - void RunL(); - - -private: // data - - /** - * Observer of the timer - */ - MUPnPMusicPeriodizerObserver& iObserver; - - /** - * Timer wavelength as milliseconds to wait between notifications - */ - TInt32 iTimerWavelength; - - }; - -/** - * The interface to receive timer notifications - */ -class MUPnPMusicPeriodizerObserver - { - -public: - - /** - * Timer has triggered - * - * @since Series 60 3.1 - */ - virtual void HandlePeriod() = 0; - - /** - * Timer has triggered - * - * @since Series 60 3.2.3 - */ - virtual void HandlePeriodForEnd(){} - - }; - - -#endif // __UPNPMUSICPERIODIZER_H__ -