platform/inc/stbhwav.h File Reference

Header file - Function prototypes for A/V control. More...

#include "stbhwc.h"
#include "osdtype.h"

Include dependency graph for stbhwav.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	S_STB_AV_COPY_PROTECTION
struct	S_STB_AV_VIDEO_INFO
Typedefs
typedef enum e_stb_av_audio_mode	E_STB_AV_AUDIO_MODE
typedef enum e_stb_av_decode_source	E_STB_AV_DECODE_SOURCE
typedef enum e_stb_av_video_codec	E_STB_AV_VIDEO_CODEC
typedef enum e_stb_av_audio_codec	E_STB_AV_AUDIO_CODEC
typedef E_ASPECT_RATIO	E_STB_AV_ASPECT_RATIO
typedef enum e_stb_av_video_format	E_STB_AV_VIDEO_FORMAT
typedef enum e_stb_av_outputs	E_STB_AV_OUTPUTS
typedef enum e_stb_av_sources	E_STB_AV_SOURCES
typedef enum e_stb_av_srm_reply	E_STB_AV_SRM_REPLY
typedef enum e_stb_av_audio_route	E_STB_AV_AUDIO_ROUTE
Enumerations
enum	e_stb_av_audio_mode {   AV_AUDIO_STEREO = 0, AV_AUDIO_LEFT = 1, AV_AUDIO_RIGHT = 2, AV_AUDIO_MONO = 3,   AV_AUDIO_MULTICHANNEL = 4 }
enum	e_stb_av_decode_source { AV_DEMUX = 0, AV_MEMORY = 1 }
enum	e_stb_av_video_codec { AV_VIDEO_CODEC_AUTO = 0, AV_VIDEO_CODEC_MPEG1 = 1, AV_VIDEO_CODEC_MPEG2 = 2, AV_VIDEO_CODEC_H264 = 3 }
enum	e_stb_av_audio_codec {   AV_AUDIO_CODEC_AUTO = 0, AV_AUDIO_CODEC_MP2 = 1, AV_AUDIO_CODEC_MP3 = 2, AV_AUDIO_CODEC_AC3 = 3,   AV_AUDIO_CODEC_EAC3 = 4, AV_AUDIO_CODEC_AAC = 5, AV_AUDIO_CODEC_HEAAC = 6 }
enum	e_stb_av_video_format {   VIDEO_FORMAT_UNDEFINED = 255, VIDEO_FORMAT_AUTO = 0, VIDEO_FORMAT_ORIGINAL, VIDEO_FORMAT_PALBGH,   VIDEO_FORMAT_PALDKL, VIDEO_FORMAT_PALI, VIDEO_FORMAT_PALM, VIDEO_FORMAT_PALN,   VIDEO_FORMAT_NTSC, VIDEO_FORMAT_SECAMBGH, VIDEO_FORMAT_SECAMDKL, VIDEO_FORMAT_576IHD,   VIDEO_FORMAT_576PHD, VIDEO_FORMAT_720HD, VIDEO_FORMAT_720P50HD, VIDEO_FORMAT_720P60HD,   VIDEO_FORMAT_1080IHD, VIDEO_FORMAT_1080P25HD, VIDEO_FORMAT_1080P30HD, VIDEO_FORMAT_1080I50HD,   VIDEO_FORMAT_1080P50HD, VIDEO_FORMAT_1080P60HD }
enum	e_stb_av_outputs { AV_OUTPUT_TV_SCART = 0, AV_OUTPUT_VCR_SCART = 1, AV_OUTPUT_AUX_SCART = 2, AV_OUTPUT_HDMI = 3 }
enum	e_stb_av_sources {   AV_SOURCE_ENCODER_SVIDEO = 0, AV_SOURCE_ENCODER_RGB = 1, AV_SOURCE_ENCODER_COMPOSITE = 2, AV_SOURCE_VCR_SVIDEO = 3,   AV_SOURCE_VCR_RGB = 4, AV_SOURCE_VCR_COMPOSITE = 5, AV_SOURCE_AUX_SVIDEO = 6, AV_SOURCE_AUX_RGB = 7,   AV_SOURCE_AUX_COMPOSITE = 8, AV_SOURCE_DVD_SVIDEO = 9, AV_SOURCE_DVD_RGB = 10, AV_SOURCE_DVD_COMPOSITE = 11,   AV_SOURCE_ANALOG_TUNER = 12, AV_SOURCE_ANALOG_TUNER_WITH_OSD = 13, AV_SOURCE_HDMI = 14, AV_SOURCE_CVBS = 15,   AV_SOURCE_TUNER = 16, AV_SOURCE_NONE = 255 }
enum	e_stb_av_srm_reply { SRM_OK = 0, SRM_BUSY = 1, SRM_NOT_REQUIRED = 2 }
enum	E_STB_AV_VIDEO_INFO_TYPE {   VIDEO_INFO_VIDEO_RESOLUTION = 0x01, VIDEO_INFO_SCREEN_RESOLUTION = 0x02, VIDEO_INFO_VIDEO_ASPECT_RATIO = 0x04, VIDEO_INFO_DISPLAY_ASPECT_RATIO = 0x08,   VIDEO_INFO_ASPECT_MODE = 0x10, VIDEO_INFO_AFD = 0x20, VIDEO_INFO_DECODER_STATUS = 0x40 }
enum	E_STB_AV_DECODER_STATUS { DECODER_STATUS_NONE, DECODER_STATUS_VIDEO, DECODER_STATUS_IFRAME }
enum	E_STB_DIGITAL_AUDIO_TYPE { DIGITAL_AUDIO_PCM, DIGITAL_AUDIO_COMPRESSED }
enum	e_stb_av_audio_route {   SPEAKER_TV_N_AD_HEADPHONE_TV_N_AD, SPEAKER_TV_ONLY_HEADPHONE_AD_ONLY, SPEAKER_TV_N_AD_HEADPHONE_AD_ONLY, SPEAKER_TV_ONLY_HEADPHONE_TV_N_AD,   AUTO_ROUTE_UNKNOWN }
Functions
void	STB_AVInitialise (U8BIT audio_paths, U8BIT video_paths)
	Initialises the AV components.
void	STB_AVBlankVideo (U8BIT path, BOOLEAN blank)
	Blanks or unblanks the video display.
void	STB_AVSetVideoSource (U8BIT path, E_STB_AV_DECODE_SOURCE source, U32BIT param)
	Sets the source of the input to the given video decoder path.
BOOLEAN	STB_AVSetVideoCodec (U8BIT path, E_STB_AV_VIDEO_CODEC codec)
	Sets the video codec to be used when decoding video with the given video decoder path.
E_STB_AV_VIDEO_CODEC	STB_AVGetVideoCodec (U8BIT path)
	Returns the video codec previously set for the given video path. This function is currently unused within DVBCore.
void	STB_AVStartVideoDecoding (U8BIT path)
	Starts video decoding on the given video path.
void	STB_AVPauseVideoDecoding (U8BIT path)
	Pauses video decoding on the given video path. The video should not be blanked.
void	STB_AVResumeVideoDecoding (U8BIT path)
	Resumes video decoding on the given video path that has previously been paused The video should not be unblanked.
void	STB_AVStopVideoDecoding (U8BIT decoder)
	Stops video decoding on the given video path. The video is not expected to be blanked.
void	STB_AVSetAudioSource (U8BIT path, E_STB_AV_DECODE_SOURCE source, U32BIT param)
	Sets the source of the input for the main audio on the given audio decoder path.
BOOLEAN	STB_AVSetAudioCodec (U8BIT path, E_STB_AV_AUDIO_CODEC codec)
	Sets the audio codec to be used when decoding audio with the given audio decoder path.
E_STB_AV_AUDIO_CODEC	STB_AVGetAudioCodec (U8BIT path)
	Returns the audio codec previously set for the given audio path. This function is currently unused within DVBCore.
void	STB_AVChangeAudioMode (U8BIT path, E_STB_AV_AUDIO_MODE mode)
	Configures the main audio channel mode (stereo/left/right) in the case where dual-mono audio is used, such that only the audio from one channel is heard.
void	STB_AVStartAudioDecoding (U8BIT decoder)
	Starts audio decoding on the given audio path.
void	STB_AVStopAudioDecoding (U8BIT decoder)
	Stops audio decoding on the given audio path.
void	STB_AVSetAudioVolume (U8BIT path, U8BIT vol)
	Sets the volume of the main audio output.
U8BIT	STB_AVGetAudioVolume (U8BIT path)
	Returns the current volume of the main audio output.
void	STB_AVSetAudioMute (U8BIT path, BOOLEAN mute)
	Mute or unmute the audio output on the given audio decoder path.
BOOLEAN	STB_AVGetAudioMute (U8BIT path)
	Returns the current mute setting of the audio output on the given path.
void	STB_AVSetADSource (U8BIT path, E_STB_AV_DECODE_SOURCE source, U32BIT param)
	Sets the source of the input for the audio description audio on the given audio decoder path.
BOOLEAN	STB_AVSetADCodec (U8BIT path, E_STB_AV_AUDIO_CODEC codec)
	Sets the codec to be used for audio description when decoding audio with the given audio decoder path.
E_STB_AV_AUDIO_CODEC	STB_AVGetADCodec (U8BIT path)
	Returns the codec previously set for audio description on the given audio path. This function is currently unused within DVBCore.
void	STB_AVChangeADMode (U8BIT path, E_STB_AV_AUDIO_MODE mode)
	Configures the audio description channel mode (stereo/left/right) in the case where dual-mono audio is used, such that only the audio from one channel is heard.
void	STB_AVStartADDecoding (U8BIT decoder)
	Starts decoding audio description on the given audio path.
void	STB_AVStopADDecoding (U8BIT decoder)
	Stops decoding audio description on the given audio path.
void	STB_AVSetADVolume (U8BIT path, U8BIT vol)
	Sets the volume of the audio description output.
U8BIT	STB_AVGetADVolume (U8BIT path)
	Returns the current volume of the audio description output.
void	STB_AVGetSTC (U8BIT path, U8BIT stc[5])
	Returns the current 33-bit System Time Clock from the PCR PES. On some systems, this information may need to be obtained from the associated demux, which will be contained in the 'param' value when STB_AVSetVideoSource is called.
void	STB_AVSetTVType (U8BIT path, E_STB_AV_ASPECT_RATIO ratio, E_STB_AV_VIDEO_FORMAT format)
	Sets the aspect ratio and signal format for the connected television.
void	STB_AVGetScreenSize (U8BIT path, U16BIT *width, U16BIT *height)
	Returns the current size of the screen in pixels.
void	STB_AVSetAVOutputSource (E_STB_AV_OUTPUTS output, E_STB_AV_SOURCES source, U32BIT param)
	Routes a specified AV source to a specified AV output.
void	STB_AVSetAVOutput (BOOLEAN av_on)
	Turns on/off all AV outputs (e.g. for standby mode)
void	STB_AVSetHDMIStandby (BOOLEAN standby)
	Sets the standby state of the HDMI output.
U8BIT	STB_AVGetHDMISupportedModes (E_STB_AV_VIDEO_FORMAT **modes)
	Returns the resolutions supported by the HDMI.
void	STB_AVGetHDMINativeResolution (U16BIT *width, U16BIT *height)
	Returns the native resolution, i.e. the resolution that is set with a call to STB_AVSetTVType(path, ratio, VIDEO_FORMAT_AUTO);.
void	STB_AVEnableHDMIDecoding (void)
	Enables AV output to HDMI.
void	STB_AVDisableHDMIDecoding (void)
	Disables AV output to HDMI.
BOOLEAN	STB_AVIsHDCPAuthenticated (void)
	Returns whether HDCP has authenticated.
BOOLEAN	STB_AVSetIFrameCodec (U8BIT path, E_STB_AV_VIDEO_CODEC codec)
	Sets the codec to be used when decoding the next i-frame from memory.
void	STB_AVLoadIFrame (U8BIT path, U8BIT *data, U32BIT size)
	Provides the video data for an i-frame for subsequent decode and display.
void	STB_AVShowIFrame (U8BIT path)
	Decodes and displays the previously loaded i-frame data.
void	STB_AVHideIFrame (U8BIT path)
	Hides the i-frame currently being displayed.
E_HW_STATUS	STB_AVPlayAudioSample (U8BIT path, U32BIT loop_count)
	Plays back a previously loaded audio sample.
E_HW_STATUS	STB_AVLoadAudioSample (U8BIT path, U8BIT *data, U32BIT size)
	Loads an audio sample for subsequent playback.
E_HW_STATUS	STB_AVPauseAudioSample (U8BIT path)
	Pauses playback of an audio sample.
E_HW_STATUS	STB_AVResumeAudioSample (U8BIT path)
	Resumes playback of an audio sample.
void	STB_AVStopAudioSample (U8BIT path)
	Stops playback of an audio sample.
void	STB_AVSetSpdifMode (U8BIT path, E_STB_DIGITAL_AUDIO_TYPE audio_type)
	Sets the SPDIF output mode, PCM or compressed audio.
void	STB_AVSetHDMIAudioMode (U8BIT path, E_STB_DIGITAL_AUDIO_TYPE audio_type)
	Sets the HDMI audio output mode, PCM or compressed.
void	STB_AVSetAudioDelay (U8BIT path, U16BIT millisecond)
	Sets the audio delay on the given path.
void	STB_AVSetVideoCallback (U8BIT path, void(*callback)(S_STB_AV_VIDEO_INFO *, void *), void *user_data)
	Register callback for updated video information.
void	STB_AVApplyVideoTransformation (U8BIT path, S_RECTANGLE *input, S_RECTANGLE *output)
	Apply video transformation.
S16BIT	STB_AVGetMinPlaySpeed (U8BIT video_decoder)
	Returns minimum video play speed as a percentage.
S16BIT	STB_AVGetMaxPlaySpeed (U8BIT video_decoder)
	Returns maximum video play speed as a percentage.
S16BIT	STB_AVGetNextPlaySpeed (U8BIT video_decoder, S16BIT speed, S16BIT inc, BOOLEAN include_slow_speeds)
	Returns the next valid speed that is +/- inc above or below the given speed. Slow motion speeds (>-100% and < 100%) can be included.
void	STB_AVSetCopyProtection (S_STB_AV_COPY_PROTECTION *copy_protection)
	Apply the specified copy protection. This function is used for CI+.
void	STB_AVSetUhfModulatorChannel (U8BIT chan)
	Sets the output channel of the RF Modulator.
U8BIT	STB_AVGetUhfModulatorChannel (void)
	Gets the current RF modulator channel.
U8BIT	STB_AVGetVideoFrameRate (U8BIT path)
	Returns the frame rate of the video being decoded.
E_STB_AV_SRM_REPLY	STB_AVApplySRM (U8BIT path, U8BIT *data, U32BIT len)
	Apply System Renewability Message (SRM) to HDCP function.
void	STB_AVCECOneTouchPlay (void)
E_STB_AV_VIDEO_FORMAT	STB_AVGetHDMINativeFormat (void)
void	STB_AVPlayMp3 (U8BIT path, U8BIT *buffer, U32BIT buffer_size)
void	STB_AVStopMp3 (U8BIT path)

---

Detailed Description

Header file - Function prototypes for A/V control.

Date:

06/02/2001

---

Function Documentation

E_STB_AV_SRM_REPLY STB_AVApplySRM	(	U8BIT	path,
		U8BIT *	data,
		U32BIT	len
	)

Apply System Renewability Message (SRM) to HDCP function.

Parameters:

path	output path
data	SRM data
len	length of SRM data in bytes

Returns:

SRM_OK, SRM_BUSY or SRM_NOT_REQUIRED

void STB_AVApplyVideoTransformation	(	U8BIT	path,
		S_RECTANGLE *	input,
		S_RECTANGLE *	output
	)

Apply video transformation.

Parameters:

path	decoder path
input	input video rectangle
output	output video rectangle

void STB_AVBlankVideo	(	U8BIT	path,
		BOOLEAN	blank
	)

Blanks or unblanks the video display.

Parameters:

path	video path
blank	TRUE to blank, FALSE to unblank

void STB_AVChangeADMode	(	U8BIT	path,
		E_STB_AV_AUDIO_MODE	mode
	)

Configures the audio description channel mode (stereo/left/right) in the case where dual-mono audio is used, such that only the audio from one channel is heard.

Parameters:

path	audio path to be configured
mode	audio mode to use

void STB_AVChangeAudioMode	(	U8BIT	path,
		E_STB_AV_AUDIO_MODE	mode
	)

Configures the main audio channel mode (stereo/left/right) in the case where dual-mono audio is used, such that only the audio from one channel is heard.

Parameters:

path	audio path to be configured
mode	audio mode to use

E_STB_AV_AUDIO_CODEC STB_AVGetADCodec

(

U8BIT

path

)

Returns the codec previously set for audio description on the given audio path. This function is currently unused within DVBCore.

Parameters:

path	audio path

Returns:

codec previously set

U8BIT STB_AVGetADVolume

(

U8BIT

path

)

Returns the current volume of the audio description output.

Parameters:

path	audio path

Returns:

audio volume (0-100%)

E_STB_AV_AUDIO_CODEC STB_AVGetAudioCodec

(

U8BIT

path

)

Returns the audio codec previously set for the given audio path. This function is currently unused within DVBCore.

Parameters:

path	audio path

Returns:

codec previously set

BOOLEAN STB_AVGetAudioMute

(

U8BIT

path

)

Returns the current mute setting of the audio output on the given path.

Parameters:

path	audio path

Returns:

TRUE if audio is muted, FALSE otherwise

U8BIT STB_AVGetAudioVolume

(

U8BIT

path

)

Returns the current volume of the main audio output.

Parameters:

path	audio path

Returns:

audio volume (0-100%)

void STB_AVGetHDMINativeResolution	(	U16BIT *	width,
		U16BIT *	height
	)

Returns the native resolution, i.e. the resolution that is set with a call to STB_AVSetTVType(path, ratio, VIDEO_FORMAT_AUTO);.

Parameters:

width	pointer to the variable where to store the width
height	pointer to the variable where to store the height

U8BIT STB_AVGetHDMISupportedModes

(

E_STB_AV_VIDEO_FORMAT **

modes

)

Returns the resolutions supported by the HDMI.

Parameters:

modes

array of supported modes

Returns:

number of supported modes

S16BIT STB_AVGetMaxPlaySpeed

(

U8BIT

video_decoder

)

Returns maximum video play speed as a percentage.

Parameters:

video_decoder

video decoder path

Returns:

Maximum play speed.

S16BIT STB_AVGetMinPlaySpeed

(

U8BIT

video_decoder

)

Returns minimum video play speed as a percentage.

Parameters:

video_decoder

video decoder path

Returns:

Minimum play speed.

S16BIT STB_AVGetNextPlaySpeed	(	U8BIT	video_decoder,
		S16BIT	speed,
		S16BIT	inc,
		BOOLEAN	include_slow_speeds
	)

Returns the next valid speed that is +/- inc above or below the given speed. Slow motion speeds (>-100% and < 100%) can be included.

Parameters:

path	Decode path
speed	Percentage speed above/below which the new speed is calculated
inc	number of speeds above that specified to return
include_slow_speeds	selects whether speeds >-100% and <100% are included

Returns:

Speed as a percentage

void STB_AVGetScreenSize	(	U8BIT	path,
		U16BIT *	width,
		U16BIT *	height
	)

Returns the current size of the screen in pixels.

Parameters:

path	0
width	returned width
height	returned height

void STB_AVGetSTC	(	U8BIT	path,
		U8BIT	stc[5]
	)

Returns the current 33-bit System Time Clock from the PCR PES. On some systems, this information may need to be obtained from the associated demux, which will be contained in the 'param' value when STB_AVSetVideoSource is called.

Parameters:

path	video path
stc	an array in which the STC will be returned, ordered such that stc[0] contains the MS bit (33) of the STC value and stc[4] contains the LS bits (0-7).

U8BIT STB_AVGetUhfModulatorChannel

(

void

)

Gets the current RF modulator channel.

Returns:

The RF frequency as a UHF channel number

E_STB_AV_VIDEO_CODEC STB_AVGetVideoCodec

(

U8BIT

path

)

Returns the video codec previously set for the given video path. This function is currently unused within DVBCore.

Parameters:

path	video path

Returns:

codec previously set

U8BIT STB_AVGetVideoFrameRate

(

U8BIT

path

)

Returns the frame rate of the video being decoded.

Parameters:

path	video path

Returns:

video frame rate in frame per seconds

void STB_AVHideIFrame

(

U8BIT

path

)

Hides the i-frame currently being displayed.

Parameters:

path	video path to use

void STB_AVInitialise	(	U8BIT	audio_paths,
		U8BIT	video_paths
	)

Initialises the AV components.

Parameters:

audio_paths	number of audio decoders
video_paths	number of video decoders

BOOLEAN STB_AVIsHDCPAuthenticated

(

void

)

Returns whether HDCP has authenticated.

Returns:

TRUE if authenticated, FALSE otherwise

E_HW_STATUS STB_AVLoadAudioSample	(	U8BIT	path,
		U8BIT *	data,
		U32BIT	size
	)

Loads an audio sample for subsequent playback.

Parameters:

path	the decoder path to use for playback
data	the audio sample data to be loaded
size	the size of the audio sample in bytes

Returns:

HW_OK on success, error code otherwise

void STB_AVLoadIFrame	(	U8BIT	path,
		U8BIT *	data,
		U32BIT	size
	)

Provides the video data for an i-frame for subsequent decode and display.

Parameters:

path	video decode path to be used
data	i-frame data to be saved for decoding
size	size of the data in bytes

E_HW_STATUS STB_AVPauseAudioSample

(

U8BIT

path

)

Pauses playback of an audio sample.

Parameters:

path	Audio path on which to pause

Returns:

HW_OK on success, error code otherwise

void STB_AVPauseVideoDecoding

(

U8BIT

path

)

Pauses video decoding on the given video path. The video should not be blanked.

Parameters:

path	video decoder path to be paused

E_HW_STATUS STB_AVPlayAudioSample	(	U8BIT	path,
		U32BIT	loop_count
	)

Plays back a previously loaded audio sample.

Parameters:

path	the audio path to use for playback
loop_count	the number of times to play the sample, 0=forever

Returns:

HW_OK on success, error code otherwise

E_HW_STATUS STB_AVResumeAudioSample

(

U8BIT

path

)

Resumes playback of an audio sample.

Parameters:

path	Audio path on which to resume

Returns:

HW_OK on success, error code otherwise

void STB_AVResumeVideoDecoding

(

U8BIT

path

)

Resumes video decoding on the given video path that has previously been paused The video should not be unblanked.

Parameters:

path	video decoder path to be resumed

BOOLEAN STB_AVSetADCodec	(	U8BIT	path,
		E_STB_AV_AUDIO_CODEC	codec
	)

Sets the codec to be used for audio description when decoding audio with the given audio decoder path.

Parameters:

path	audio path
codec	codec to be used

Returns:

TRUE if the codec is supported and is set correctly, FALSE otherwise

void STB_AVSetADSource	(	U8BIT	path,
		E_STB_AV_DECODE_SOURCE	source,
		U32BIT	param
	)

Sets the source of the input for the audio description audio on the given audio decoder path.

Parameters:

path	audio path to configure
source	the source device to use
param	parameter set with the source, typically the tuner or demux number

void STB_AVSetADVolume	(	U8BIT	path,
		U8BIT	vol
	)

Sets the volume of the audio description output.

Parameters:

path	audio path to be configured
vol	audio volume (0-100%)

BOOLEAN STB_AVSetAudioCodec	(	U8BIT	path,
		E_STB_AV_AUDIO_CODEC	codec
	)

Sets the audio codec to be used when decoding audio with the given audio decoder path.

Parameters:

path	audio path
codec	codec to be used

Returns:

TRUE if the codec is supported and is set correctly, FALSE otherwise

void STB_AVSetAudioDelay	(	U8BIT	path,
		U16BIT	millisecond
	)

Sets the audio delay on the given path.

Parameters:

path	decoder path
millisecond	audio delay to be applied

void STB_AVSetAudioMute	(	U8BIT	path,
		BOOLEAN	mute
	)

Mute or unmute the audio output on the given audio decoder path.

Parameters:

path	audio path to be configured
mute	TRUE to mute, FALSE to unmute

void STB_AVSetAudioSource	(	U8BIT	path,
		E_STB_AV_DECODE_SOURCE	source,
		U32BIT	param
	)

Sets the source of the input for the main audio on the given audio decoder path.

Parameters:

path	audio path to configure
source	the source device to use
param	parameter set with the source, typically the tuner or demux number

void STB_AVSetAudioVolume	(	U8BIT	path,
		U8BIT	vol
	)

Sets the volume of the main audio output.

Parameters:

path	audio path to be configured
vol	audio volume (0-100%)

void STB_AVSetAVOutput

(

BOOLEAN

av_on

)

Turns on/off all AV outputs (e.g. for standby mode)

Parameters:

av_on

TRUE to turn on, FALSE to turn off

void STB_AVSetAVOutputSource	(	E_STB_AV_OUTPUTS	output,
		E_STB_AV_SOURCES	source,
		U32BIT	param
	)

Routes a specified AV source to a specified AV output.

Parameters:

output	The output to be connected
source	The source signal to be connected
param	parameter associated with the source

void STB_AVSetCopyProtection

(

S_STB_AV_COPY_PROTECTION *

copy_protection

)

Apply the specified copy protection. This function is used for CI+.

Parameters:

copy_protection

void STB_AVSetHDMIAudioMode	(	U8BIT	path,
		E_STB_DIGITAL_AUDIO_TYPE	audio_type
	)

Sets the HDMI audio output mode, PCM or compressed.

Parameters:

path	decoder path
audio_type	PCM or compressed

void STB_AVSetHDMIStandby

(

BOOLEAN

standby

)

Sets the standby state of the HDMI output.

Parameters:

standby

TRUE to put the HDMI in standby, FALSE to come out of standby

BOOLEAN STB_AVSetIFrameCodec	(	U8BIT	path,
		E_STB_AV_VIDEO_CODEC	codec
	)

Sets the codec to be used when decoding the next i-frame from memory.

Parameters:

path	video path
codec	codec to be used

Returns:

TRUE if the codec is supported and is set correctly, FALSE otherwise

void STB_AVSetSpdifMode	(	U8BIT	path,
		E_STB_DIGITAL_AUDIO_TYPE	audio_type
	)

Sets the SPDIF output mode, PCM or compressed audio.

Parameters:

path	decoder path
spdif_type	PCM or compressed

void STB_AVSetTVType	(	U8BIT	path,
		E_STB_AV_ASPECT_RATIO	ratio,
		E_STB_AV_VIDEO_FORMAT	format
	)

Sets the aspect ratio and signal format for the connected television.

Parameters:

path	The video path to be set
ratio	The aspect ratio of the tv
format	The signal format of the tv

void STB_AVSetUhfModulatorChannel

(

U8BIT

chan

)

Sets the output channel of the RF Modulator.

Parameters:

chan	the UHF channel number

void STB_AVSetVideoCallback	(	U8BIT	path,
		void(*)(S_STB_AV_VIDEO_INFO *, void *)	callback,
		void *	user_data
	)

Register callback for updated video information.

Parameters:

path	decoder path
callback	the callback to call when video information is updated
user_data	user data to pass to the callback

BOOLEAN STB_AVSetVideoCodec	(	U8BIT	path,
		E_STB_AV_VIDEO_CODEC	codec
	)

Sets the video codec to be used when decoding video with the given video decoder path.

Parameters:

path	video path
codec	codec to be used

Returns:

TRUE if the codec is supported and is set correctly, FALSE otherwise

void STB_AVSetVideoSource	(	U8BIT	path,
		E_STB_AV_DECODE_SOURCE	source,
		U32BIT	param
	)

Sets the source of the input to the given video decoder path.

Parameters:

path	video path to configure
source	the source device to use
param	parameter set with the source, typically the tuner or demux number

void STB_AVShowIFrame

(

U8BIT

path

)

Decodes and displays the previously loaded i-frame data.

Parameters:

path	video path to use

void STB_AVStartADDecoding

(

U8BIT

decoder

)

Starts decoding audio description on the given audio path.

Parameters:

path	audio decoder path to be started

void STB_AVStartAudioDecoding

(

U8BIT

decoder

)

Starts audio decoding on the given audio path.

Parameters:

path	audio decoder path to be started

void STB_AVStartVideoDecoding

(

U8BIT

path

)

Starts video decoding on the given video path.

Parameters:

path	video decoder path to be started

void STB_AVStopADDecoding

(

U8BIT

decoder

)

Stops decoding audio description on the given audio path.

Parameters:

path	audio decoder path to be stopped

void STB_AVStopAudioDecoding

(

U8BIT

decoder

)

Stops audio decoding on the given audio path.

Parameters:

path	audio decoder path to be stopped

void STB_AVStopAudioSample

(

U8BIT

path

)

Stops playback of an audio sample.

Parameters:

path	Audio path on which to stop

void STB_AVStopVideoDecoding

(

U8BIT

decoder

)

Stops video decoding on the given video path. The video is not expected to be blanked.

Parameters:

path	video decoder path to be stopped