ppb_program_schedule_samsung.h

Go to the documentation of this file.

/* Copyright (c) 2015 Samsung Electronics. All rights reserved.
 */

/* From samsung/ppb_program_schedule_samsung.idl,
 *   modified Fri Aug 14 12:48:58 2015.
 */

#ifndef PPAPI_C_SAMSUNG_PPB_PROGRAM_SCHEDULE_SAMSUNG_H_
#define PPAPI_C_SAMSUNG_PPB_PROGRAM_SCHEDULE_SAMSUNG_H_

#include "ppapi/c/pp_array_output.h"
#include "ppapi/c/pp_bool.h"
#include "ppapi/c/pp_completion_callback.h"
#include "ppapi/c/pp_macros.h"
#include "ppapi/c/pp_resource.h"
#include "ppapi/c/pp_stdint.h"
#include "ppapi/c/pp_time.h"
#include "ppapi/c/pp_var.h"
#include "ppapi/c/samsung/pp_epg_event_samsung.h"

#define PPB_PROGRAMSCHEDULE_SAMSUNG_INTERFACE_0_2 \
    "PPB_ProgramSchedule_Samsung;0.2"
#define PPB_PROGRAMSCHEDULE_SAMSUNG_INTERFACE \
    PPB_PROGRAMSCHEDULE_SAMSUNG_INTERFACE_0_2

/**
 * @file
 * This file defines the <code>PPB_ProgramSchedule_Samsung</code> interface.
 */


/**
 * @addtogroup Enums
 * @{
 */
/**
 * Enum that defines program genre
 */
typedef enum {
  PP_PROGRAM_GENRE_UNKNOWN = 0xFF,
  PP_PROGRAM_GENRE_HAUPTPROGRAMME = 0x00,
  PP_PROGRAM_GENRE_SPIELFILM_SERIE = 0x01,
  PP_PROGRAM_GENRE_SPOT = 0x02,
  PP_PROGRAM_GENRE_NEWS_DOKU_KULTUR = 0x03,
  PP_PROGRAM_GENRE_MUSIK_LIFESTYLE_COMEDY = 0x04,
  PP_PROGRAM_GENRE_KINDER = 0x05,
  PP_PROGRAM_GENRE_SHOPPING = 0x06,
  PP_PROGRAM_GENRE_QUIZ_SPIELE = 0x07,
  PP_PROGRAM_GENRE_REGIONAL_BADEN_WURTTEMBERG = 0x64,
  PP_PROGRAM_GENRE_REGIONAL_BAYERN = 0x65,
  PP_PROGRAM_GENRE_REGIONAL_BERLIN_BRANDENBURG = 0x66,
  PP_PROGRAM_GENRE_REGIONAL_BREMEN = 0x67,
  PP_PROGRAM_GENRE_REGIONAL_HAMBURG = 0x68,
  PP_PROGRAM_GENRE_REGIONAL_HESSEN = 0x69,
  PP_PROGRAM_GENRE_REGIONAL_MECKLENBURG_VORPOMMERN = 0x6A,
  PP_PROGRAM_GENRE_REGIONAL_NIEDERSACHSEN = 0x6B,
  PP_PROGRAM_GENRE_REGIONAL_NORDRHEIN_WESTFALEN = 0x6C,
  PP_PROGRAM_GENRE_REGIONAL_RHEINLAND_PFALZ = 0x6D,
  PP_PROGRAM_GENRE_REGIONAL_SAARLAND = 0x6E,
  PP_PROGRAM_GENRE_REGIONAL_SACHSEN = 0x6F,
  PP_PROGRAM_GENRE_REGIONAL_SACHSEN_ANHALT = 0x70,
  PP_PROGRAM_GENRE_REGIONAL_SCHLESWIG_HOLSTEIN = 0x71,
  PP_PROGRAM_GENRE_REGIONAL_THURINGEN = 0x72,
  PP_PROGRAM_GENRE_WEITERE_FREMDSPRACHEN = 0xC8,
  PP_PROGRAM_GENRE_WEITERE_EROTIK = 0xC9,
  PP_PROGRAM_GENRE_WEITERE_ANDERE = 0xCA
} PP_ProgramGenre;
PP_COMPILE_ASSERT_SIZE_IN_BYTES(PP_ProgramGenre, 4);
/**
 * @}
 */

/**
 * @addtogroup Interfaces
 * @{
 */
/**
 * Interface used to retrieve EPG events from transport stream.
 */
struct PPB_ProgramSchedule_Samsung_0_2 {
  /**
   * IsProgramSchedule() checks if provided resource is program schedule.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying resource that
   * will be checked.
   *
   * @return <code>PP_TRUE<code> if resource is identifying program schedule and
   * <code>PP_FALSE<code> otherwise.
   */
  PP_Bool (*IsProgramSchedule)(PP_Resource resource);
  /**
   * GetID() provides ID of service identified by resource.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @return <code>uint64_t<code> with ID of service.
   */
  uint64_t (*GetID)(PP_Resource resource);
  /**
   * GetName() providing name of service identified by resource.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @return <code>PP_Var<code> of type string, with name of service.
   */
  struct PP_Var (*GetName)(PP_Resource resource);
  /**
   * GetType() providing type of service identified by resource.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @return <code>PP_ServiceType<code> with type of service. More information
   * in pp_epg_event.h.
   */
  PP_ServiceType (*GetType)(PP_Resource resource);
  /**
   * GetScheduledEvents() providing array of EPG events from scheduled table
   * for service associated whit program schedule resource.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @param[in] start_time <code>PP_Time</code> with beginning of
   * requested schedule.
   *
   * @param[in] end_time <code>PP_Time</code> with end of requested schedule.
   *
   * @param[in] output <code>PP_ArrayOutput</code> in which
   * <code>PP_EPGEvent</code> will be returned, ref count for vars in
   * PP_EPGEvent is increased on behalf of the plugin.
   *
   * @param[in] callback <code>PP_CompletionCallback</code> that will be run
   * when output will be ready.
   *
   * @return <code>PP_Error<code> with error code.
   */
  int32_t (*GetScheduledEvents)(PP_Resource resource,
                                PP_Time start_time,
                                PP_Time end_time,
                                struct PP_ArrayOutput output,
                                struct PP_CompletionCallback callback);
  /**
   * GetPresentFollowing() providing array of EPG events from present/following
   * table for service associated whit program schedule resource.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @param[in] output <code>PP_ArrayOutput</code> in which
   * <code>PP_EPGEvent</code> will be returned, ref count for vars in
   * PP_EPGEvent is increased on behalf of the plugin.
   *
   * @param[in] callback <code>PP_CompletionCallback</code> that will be run
   * when output will be ready.
   *
   * @return <code>PP_Error<code> with error code.
   */
  int32_t (*GetPresentFollowing)(PP_Resource resource,
                                 struct PP_ArrayOutput output,
                                 struct PP_CompletionCallback callback);
  /**
   * GetProgramGenre() gets genre of certain program from the service
   * associated with program schedule resource.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @param[in] event <code>PP_EPGEvent</code> to get genre of event.
   *
   * @param[out] genre <code>uint32_t</code> in which
   * <code>PP_ProgramGenre</code> enum will be returned.
   *
   * @param[in] callback <code>PP_CompletionCallback</code> that will be run
   * when output will be ready.
   *
   * @return <code>PP_Error<code> with error code.
   */
  int32_t (*GetProgramGenre)(PP_Resource resource,
                             const struct PP_EPGEvent* event,
                             int32_t* genre,
                             struct PP_CompletionCallback callback);
  /**
   * SetRatingLock() sets lock for displaying programs of certain rating.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @param[in] program <code>PP_RatingInfo</code> from which rating is taken
   *
   * @param[in] state <code>PP_Bool</code> of lock to be set.
   *
   * @param[in] callback <code>PP_CompletionCallback</code> that will be run
   * when output will be ready.
   *
   * @return <code>PP_Error<code> with error code.
   */
  int32_t (*SetRatingLock)(PP_Resource resource,
                           const struct PP_RatingInfo* rating_info,
                           PP_Bool set_lock,
                           struct PP_CompletionCallback callback);
  /**
   * GetRatingLock() gets lock status for displaying programs of certain rating.
   *
   * @param[in] resource A <code>PP_Resource</code> identifying program
   * schedule resource.
   *
   * @param[in] program <code>PP_RatingInfo</code> from which rating is taken
   *
   * @param[out] state <code>PP_Bool</code> of the lock.
   *
   * @param[in] callback <code>PP_CompletionCallback</code> that will be run
   * when output will be ready.
   *
   * @return <code>PP_Error<code> with error code.R
   */
  int32_t (*GetRatingLock)(PP_Resource resource,
                           const struct PP_RatingInfo* rating_info,
                           PP_Bool* lock_state,
                           struct PP_CompletionCallback callback);
};

typedef struct PPB_ProgramSchedule_Samsung_0_2 PPB_ProgramSchedule_Samsung;
/**
 * @}
 */

#endif  /* PPAPI_C_SAMSUNG_PPB_PROGRAM_SCHEDULE_SAMSUNG_H_ */