1 /*

     2 * Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:      File tranfer session

    15 *

    16 */

    17 

    18 

    19 

    20 

    21 

    22 

    23 #ifndef M_UPNPFILETRANSERSESSIONOBSERVER_H

    24 #define M_UPNPFILETRANSERSESSIONOBSERVER_H

    25 

    26 // EXTERNAL INCLUDES

    27 #include <e32std.h>

    28 

    29 // INTERNAL INCLUDES

    30 #include "upnpavsessionobserverbase.h"

    31 

    32 // CLASS DECLARATION

    33 /**

    34  *  AV Controller file transfer session observer interface.

    35  *

    36  *  @since S60 v3.2

    37  */

    38  class MUPnPFileTransferSessionObserver : public MUPnPAVSessionObserverBase

    39     {   

    40     

    41 public:

    42 

    43     /**

    44      * Notifies that the transfer has been started

    45      *

    46      * @param aKey identifies the transfer

    47      * @param aStatus status (error) code

    48      */        

    49     virtual void TransferStarted( TInt aKey, TInt aStatus ) = 0;

    50     

    51     /**

    52      * Notifies that the transfer has been completed

    53      *

    54      * @param aKey identifies the transfer

    55      * @param aStatus status (error) code

    56      * @param aFilePath 

    57      */        

    58     virtual void TransferCompleted( TInt aKey, TInt aStatus,

    59         const TDesC& aFilePath ) = 0;

    60     

    61     /**

    62      * Notifies transfer progress

    63      * NOTE: Transfer progress is not guaranteed

    64      *

    65      * @param aKey identifies the transfer

    66      * @param aBytes amount of bytes downloaded

    67      * @param aTotalBytes total amount of bytes

    68      */        

    69     virtual void TransferProgress( TInt aKey, TInt aBytes,

    70         TInt aTotalBytes ) = 0;

    71 

    72     /**

    73      * Notifies that the Media Server we have a session with has

    74      * disappeared. Session is now unusable and must be closed. 

    75      *

    76      * @since Series 60 3.1

    77      * @param aReason reason code

    78      * @return None

    79      */        

    80     virtual void MediaServerDisappeared(

    81         TUPnPDeviceDisconnectedReason aReason ) = 0;

    82     

    83     };

    84 

    85 #endif // M_UPNPFILETRANSERSESSIONOBSERVER_H

    86 

    87 // End of file

    88