IPlfApiPreset

General info

One in which the platform internally captures and stores the required preset information and uses it for zapping, and
One in which the middleware captures and stores the required information and provides it as a preset to the platform as a request to zap to the specified station.

StorePresetSupported() and StoreAttributeSupported() return false: LoadAttribute(), StoreAttribute(), LoadPreset(), StorePreset() will not be called.
Only one preset is supported by the platform: GetMinPreset() can equal GetMaxPreset().

API usage

switching to the requested frequency but with finetuning enabled, similar to SetFreq() with finetuning set.
enabling of AFC.
automatic TV system detection, similar to SetTvSystem() with TvSystemNone.
automatic color system detection, similar to SuggestColorSystemEx() with UnknownColorSystem.

Constants

Functions/Parameters

FResult InitPreset( int winid, int preset, Nat32 * retval )

Parameters	preset	An index to a preset structure.
	retval	Standard return value.

FResult GetMinPreset( int winid, int * PresetIndex, Nat32 * retval )

Parameters	PresetIndex	Minimum valid preset index.
	retval	Standard return value.

FResult GetMaxPreset( int winid, int * PresetIndex, Nat32 * retval )

Parameters	PresetIndex	Maximum valid preset index.
	retval	Standard return value.

FResult SetPreset( int winid, tmPlfInstPreset_Source_t source, int preset, Nat32 * retval )

Parameters	source	Source of the signal path for which the preset is to be set. In a single tuner environment, only tmPlfInstPreset_tvsrcMainTuner is used.
	preset	Index to a preset structure.
	retval	Standard return value.

FResult GetPreset( int winid, tmPlfInstPreset_Source_t source, int * Preset, Nat32 * retval )

Parameters	source	Source of the signal path for which the preset is to be set. In a single tuner environment, only tmPlfInstPreset_tvsrcMainTuner is used.
	Preset	Preset index belonging to the source specified.
	retval	Standard return value.

FResult FillPreset( int winid, tmPlfInstPreset_Source_t source, int preset, Nat32 * retval )

Parameters	source	Source of the signal path for which the preset is to be set. In a single tuner environment, only tmPlfInstPreset_tvsrcMainTuner is used.
	preset	Index to a preset structure.
	retval	Standard return value.

FResult StorePreset( int winid, int preset, Nat32 * retval )

Parameters	preset	Index to a preset structure
	retval	Standard return value.

FResult LoadPreset( int winid, int preset, Nat32 * retval )

Parameters	preset	Index to a preset structure.
	retval	Standard return value.

FResult StorePresetSupported( int winid, Bool * Supported, Nat32 * retval )

Parameters	Supported	TRUE if presets are supported, FALSE otherwise.
	retval	Standard return value.

FResult SwapPreset( int winid, int preset1, int preset2, Nat32 * retval )

Parameters	preset1	Defines the first preset to be swapped.
	preset2	Defines the second preset to be swapped.
	retval	Standard return value.

FResult GetAttribute( int winid, int preset, tmPlfInstPreset_PresetAttribute_t attribute, int * Value, Nat32 * retval )

Parameters	preset	Preset for which the attribute value has to be retrieved.
	attribute	Defines the attribute.
	Value	The value of the attribute of the specified preset.
	retval	Standard return value.

FResult SetAttribute( int winid, int preset, tmPlfInstPreset_PresetAttribute_t attribute, int value, Nat32 * retval )

FResult StoreAttribute( int winid, int preset, tmPlfInstPreset_PresetAttribute_t attribute, Nat32 * retval )

FResult LoadAttribute( int winid, int preset, tmPlfInstPreset_PresetAttribute_t attribute, Nat32 * retval )

FResult StoreAttributeSupported( int winid, tmPlfInstPreset_PresetAttribute_t attribute, Bool * Supported, Nat32 * retval )

Parameters	attribute	Defines the attribute.
	Supported	TRUE if the attribute can be stored in persistent memory, FALSE otherwise.
	retval	Standard return value.