mv_dec02.c

tuner扫描

/*==========================================================================*/
/*     (Copyright (C) 2003 Koninklijke Philips Electronics N.V.             */
/*     All rights reserved.                                                 */
/*     This source code and any compilation or derivative thereof is the    */
/*     proprietary information of Koninklijke Philips Electronics N.V.      */
/*     and is confidential in nature.                                       */
/*     Under no circumstances is this software to be exposed to or placed   */
/*     under an Open Source License of any type without the expressed       */
/*     written permission of Koninklijke Philips Electronics N.V.           */
/*==========================================================================*/
/*==========================================================================*/
/*                                                                          
       SOURCE_FILE:    MV_DEC02.C

       PACKAGE:        DEC
       COMPONENT:      MV
                                                                            
       (C) 1998: Philips Semiconductors                                
                                                                            */ 
/*==========================================================================*/
/*MPP:::DEC======================================================*/

/* PACKAGE NAME:       DEC

   SCOPE:              PLATEFORM
      
   ORIGINAL AUTHOR:    B.LEMESLE

   DESCRIPTION :  
   Basic functionalities of the video decoding package to install,
   enable and disable notification to application

   DATA TYPES:

   FUNCTIONS:
   MV_DEC_install_notify
   MV_DEC_enable_notification
   MV_DEC_disable_notification

                                                                            */
/*EMP=======================================================================*/

/*==========================================================================*/
/*       I N C L U D E S                                                    */ 
/*==========================================================================*/

#include "standard.h"
#include "mv_decl.h"
#include "mv_decp.h"
#include "mv_drv.h"

/*==========================================================================*/
/*       G L O B A L   D A T A   D E C L A R A T I O N S                    */
/*==========================================================================*/

/*==========================================================================*/
/*       L O C A L   S Y M B O L   D E F I N I T I O N S                    */
/*==========================================================================*/

/*==========================================================================*/
/*       L O C A L   D A T A   D E C L A R A T I O N S                      */
/*==========================================================================*/

/*==========================================================================*/
/*       L O C A L   F U N C T I O N S   P R O T O T Y P E S                */
/*==========================================================================*/

/*==========================================================================*/
/*       G L O B A L  F U N C T I O N S                                     */ 
/*==========================================================================*/
/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_install_notify

    PACKAGE:           DEC

    SCOPE:             PLATEFORM

    DESCRIPTION:
    Install a notification callback function.
    The function installed must be provided by the application.
    When an event occurs and when the event has been enabled,
    the notify function is called back with the occurring event as
    parameter (in_event).
    By default, the events are disabled.
    With MV_DEC_enable_notification(), they can be enabled. 


    PRECONDITIONS:
    None

    POSTCONDITIONS:
    after call to this function, calling to MV_DEC_enable_notification() or
    MV_DEC_disable_notification() is possible

    CALLING SEQUENCE:
*/
extern void
MV_DEC_install_notify(    
   void    (*in_function_ptr)(MV_DEC_EVENT in_event)
   )
/*EMP=======================================================================*/
{
   GV_MV_DEC_status.function_ptr = in_function_ptr;
   
} /* End of MV_DEC_install_notify */

/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_enable_notification

    PACKAGE:           DEC

    SCOPE:             PLATEFORM

    DESCRIPTION:
    This function enables the events for which a notification will be given.
    When an event  occurs, the notify function is called that is installed
    for the event.
    By default, no events are enabled. 

    NOTES:
    Notify functions themselves are not part of the API but must be provided
    by the application.   

    PRECONDITIONS:
    Notify functions for the events are installed via MV_DEC_install_notify().

    POSTCONDITIONS:
    None
    
    CALLING SEQUENCE:
*/
extern void
MV_DEC_enable_notification(    
   MV_DEC_EVENT        in_events
   )
/*EMP=======================================================================*/
{
   /* Add event to mask */
   GV_MV_DEC_status.dec_event_enabled |= in_events;

} /* End of MV_DEC_enable_notification */

/*MPF=======================================================================*/
/*  
    FUNCTION NAME:     MV_DEC_disable_notification

    PACKAGE:           DEC

    SCOPE:             PLATEFORM

    DESCRIPTION:
    This function disables that a notification is given for the specified
    events. The notification can be enabled via the MV_DEC_enable_notification.
    Note that notify functions themselves are not part of the API but must
    be provided by the application.

    PRECONDITIONS:
    Notify functions for the events are installed via MV_IDEC_install_notify().

    POSTCONDITIONS:
    None
    
    CALLING SEQUENCE:
*/
extern void
MV_DEC_disable_notification(    
   MV_DEC_EVENT        in_events
   )
/*EMP=======================================================================*/
{
   GV_MV_DEC_status.dec_event_enabled &= ~in_events;
   
} /* End of MV_DEC_disable_notification */

/*==========================================================================*/
/*       L O C A L  F U N C T I O N S                                       */ 
/*==========================================================================*/