1 /*

     2 * Copyright (c) 2004 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:  Recognizer for 3GP files.

    15 *

    16 */

    17 

    18 

    19 

    20 #ifndef C3GPAUDIOPLAYCONTROLLERRECOGNIZER_H

    21 #define C3GPAUDIOPLAYCONTROLLERRECOGNIZER_H

    22 

    23 // INCLUDES

    24 #include <e32base.h>

    25 #include <apmrec.h>

    26 #include <apmstd.h>

    27 

    28 // CLASS DECLARATION

    29 

    30 /**

    31 * Concrete implementation of the recognizer API used to recognize 3GP files.

    32 *

    33 *  @lib 3GPAudioPlayControllerRecognizer.lib

    34 *  @since 3.0

    35 */

    36 class C3GPAudioPlayControllerRecognizer : public CApaDataRecognizerType

    37 	{

    38     public:  // Constructors and destructor

    39 

    40         /**

    41         * Two-phased constructor.

    42         */

    43         static C3GPAudioPlayControllerRecognizer* NewL();

    44 

    45         /**

    46         * Destructor

    47         */

    48 		virtual ~C3GPAudioPlayControllerRecognizer();

    49 

    50         /**

    51         * Creates recognizer

    52         * @since 3.0

    53         * @param  none

    54         * @return recognizer instance

    55         */

    56 		static CApaDataRecognizerType* CreateRecognizerL();

    57 

    58     private: // Functions from base classes

    59 

    60         /**

    61         * From CApaDataRecognizerType

    62         * Returns one of the SupportedDataType

    63         * @since 3.0

    64         * @param aIndex - depending on the file extension

    65         * @return Supported DataType

    66         */

    67         TDataType SupportedDataTypeL( TInt aIndex ) const;

    68 

    69         /**

    70         * From CApaDataRecognizerType

    71         * Returns the buffersize needed to scan

    72         * @since 3.0

    73         * @param  none

    74         * @return BufferSize if needed

    75         */

    76 		TUint PreferredBufSize();

    77 

    78         /**

    79         * From CApaDataRecognizerType

    80         * Do the recognition of the file using the name of the

    81         * the file or the buffer to scan

    82         * @since 3.0

    83         * @param aName    Name of the file

    84         * @param aBuffer  Buffer that shall be scanned for recognition

    85         * @return void

    86         */

    87 		void DoRecognizeL( const TDesC& aName, const TDesC8& aBuffer );

    88 

    89     private:

    90 

    91         /**

    92         * C++ default constructor.

    93         */

    94         C3GPAudioPlayControllerRecognizer();

    95 

    96         /**

    97         * By default Symbian 2nd phase constructor is private.

    98         */

    99         void ConstructL();

   100 

   101     private:	// Data

   102 

   103 	};

   104 

   105 #endif		// C3GPAUDIOPLAYCONTROLLERRECOGNIZER_H