1 /*

     2 * Copyright (c) 2005-2009 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 the License "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:  Interface for operations registered as frame handlers

    15 *

    16 */

    17 

    18 

    19 #ifndef ABS_CORE_FRAME_HANDLER_H

    20 #define ABS_CORE_FRAME_HANDLER_H

    21 

    22 #include "am_platform_libraries.h"

    23 #include "core_types.h"

    24 

    25 class core_frame_dot11_c;

    26 class core_frame_ethernet_c;

    27 class core_frame_echo_test_c;

    28 

    29 /**

    30  * Abstract interface for operations wanting to handle frames themselves.

    31  *

    32  * @since S60 v3.1

    33  */

    34 class abs_core_frame_handler_c

    35     {

    36 public:

    37 

    38     /**

    39      * Destructor.

    40      */

    41     virtual ~abs_core_frame_handler_c() {};

    42 

    43     /**

    44      * Called by the core server when a dot11 frame has been received.

    45      *

    46      * @since S60 v3.1

    47      * @param frame Pointer to a dot11 frame parser.

    48      * @param rcpi RCPI value of the frame.

    49      * @return true_t if the frame was handled, false_t otherwise.

    50      */

    51     virtual bool_t receive_frame(

    52         const core_frame_dot11_c* /* frame */,

    53         u8_t /* rcpi */ ) { return false_t; }

    54 

    55     /**

    56      * Called by the core server when an echo test frame has been received.

    57      *

    58      * @since S60 v3.2

    59      * @param frame Pointer to an echo test frame parser.

    60      * @param rcpi RCPI value of the frame.

    61      * @return true_t if the frame was handled, false_t otherwise.

    62      */

    63     virtual bool_t receive_test_frame(

    64         const core_frame_echo_test_c* /* frame */,

    65         u8_t /* rcpi */ ) { return false_t; }

    66     };

    67 

    68 #endif // ABS_CORE_FRAME_HANDLER_H