IPlfApiPreset
  1. General info

  2. A preset contains the information that is needed to zap to a particular station. This information is captured during installation and used during zapping to prevent that it has to be detected anew. The information is stored in a preset structure, which has the following attributes: Presets are only used for analog zapping, not for digital. A client of the platform has to select an analog tuner as a source explicitly (using the SourceSetup interface) before selecting a preset: use case selection is not part of preset selection.

    The Preset interface supports two modes of operation:
    Currently, only the latter mode is used by the middleware. A valid and recommended implementation for platforms supporting a single tuner, is the following:
    API usage

    Typical usage is that first the individual attributes of a preset structure inside the platform are set via a number of client calls to SetAttribute(). When the preset has been defined, the clients calls a SetPreset() for this preset structure. This commits all values that have been set for the individual attributes to the platform. The intended behaviour is that the platform makes a transition to the specified values as quickly and smoothly as possible. As a rough outline, if OnStationFound has been set in the preset structure, then a SetPreset() will result in: The order in which the platform performs these action is internal to the platform: the intention is that they should be as quickly and smoothly as possible. The platform is expected to give the proper notifications associated with these actions, including OnStationFound().

    If OnStationFound has not been set in the preset structure, then a SetPreset() will result in: Again, the order in which the platform performs these action is internal to the platform: the intention is that they should be as quickly and smoothly as possible. The platform is expected to give the proper notifications associated with these actions, including OnTvSystemDetected().

    1. Constants

    2. Functions/Parameters

    Copyright © 2009, Koninklijke Philips Electronics N.V.