stbhwav.h File Reference

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

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

Go to the source code of this file.

Classes
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
typedef void(*	CC_DATA_CALLBACK) (U8BIT path, void *context, U8BIT *data, U16BIT data_len)
	Callback function used to notify new closed caption data. More...

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,   AV_VIDEO_CODEC_H265 = 4, AV_VIDEO_CODEC_AVS = 5 }
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, AV_AUDIO_CODEC_AAC_ADTS = 7,   AV_AUDIO_CODEC_HEAAC_V2 = 8 }
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_720HD, VIDEO_FORMAT_720P60HD,   VIDEO_FORMAT_1080IHD, VIDEO_FORMAT_1080P25HD, VIDEO_FORMAT_1080P30HD, VIDEO_FORMAT_1080I50HD,   VIDEO_FORMAT_1080P50HD, VIDEO_FORMAT_1080P60HD, VIDEO_FORMAT_2160P24UHD, VIDEO_FORMAT_2160P25UHD,   VIDEO_FORMAT_2160P30UHD, VIDEO_FORMAT_2160P50UHD, VIDEO_FORMAT_2160P60UHD }
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, DIGITAL_AUDIO_AUTO }
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. More...
void	STB_AVBlankVideo (U8BIT path, BOOLEAN blank)
	Blanks or unblanks the video display. More...
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. More...
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. More...
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. More...
void	STB_AVStartVideoDecoding (U8BIT path)
	Starts video decoding on the given video path. More...
void	STB_AVPauseVideoDecoding (U8BIT path)
	Pauses video decoding on the given video path. The video should not be blanked. More...
void	STB_AVResumeVideoDecoding (U8BIT path)
	Resumes video decoding on the given video path that has previously been paused The video should not be unblanked. More...
void	STB_AVStopVideoDecoding (U8BIT decoder)
	Stops video decoding on the given video path. The video is not expected to be blanked. More...
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. More...
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. More...
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. More...
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. More...
void	STB_AVStartAudioDecoding (U8BIT decoder)
	Starts audio decoding on the given audio path. More...
void	STB_AVStopAudioDecoding (U8BIT decoder)
	Stops audio decoding on the given audio path. More...
void	STB_AVSetAudioVolume (U8BIT path, U8BIT vol)
	Sets the volume of the main audio output. More...
U8BIT	STB_AVGetAudioVolume (U8BIT path)
	Returns the current volume of the main audio output. More...
void	STB_AVSetAudioMute (U8BIT path, BOOLEAN mute)
	Mute or unmute the audio output on the given audio decoder path. More...
BOOLEAN	STB_AVGetAudioMute (U8BIT path)
	Returns the current mute setting of the audio output on the given path. More...
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. More...
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. More...
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. More...
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. More...
void	STB_AVStartADDecoding (U8BIT decoder)
	Starts decoding audio description on the given audio path. More...
void	STB_AVStopADDecoding (U8BIT decoder)
	Stops decoding audio description on the given audio path. More...
void	STB_AVSetADVolume (U8BIT path, U8BIT vol)
	Sets the volume of the audio description output. More...
U8BIT	STB_AVGetADVolume (U8BIT path)
	Returns the current volume of the audio description output. More...
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. More...
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. More...
void	STB_AVGetScreenSize (U8BIT path, U16BIT *width, U16BIT *height)
	Returns the current size of the screen in pixels. More...
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. More...
void	STB_AVSetAVOutput (BOOLEAN av_on)
	Turns on/off all AV outputs (e.g. for standby mode) More...
void	STB_AVSetHDMIStandby (BOOLEAN standby)
	Sets the standby state of the HDMI output. More...
U8BIT	STB_AVGetHDMISupportedModes (E_STB_AV_VIDEO_FORMAT **modes)
	Returns the resolutions supported by the HDMI. More...
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);. More...
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. More...
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. More...
void	STB_AVLoadIFrame (U8BIT path, U8BIT *data, U32BIT size)
	Provides the video data for an i-frame for subsequent decode and display. More...
void	STB_AVShowIFrame (U8BIT path)
	Decodes and displays the previously loaded i-frame data. More...
void	STB_AVHideIFrame (U8BIT path)
	Hides the i-frame currently being displayed. More...
E_HW_STATUS	STB_AVPlayAudioSample (U8BIT path, U32BIT loop_count)
	Plays back a previously loaded audio sample. More...
E_HW_STATUS	STB_AVLoadAudioSample (U8BIT path, U8BIT *data, U32BIT size)
	Loads an audio sample for subsequent playback. More...
E_HW_STATUS	STB_AVPauseAudioSample (U8BIT path)
	Pauses playback of an audio sample. More...
E_HW_STATUS	STB_AVResumeAudioSample (U8BIT path)
	Resumes playback of an audio sample. More...
void	STB_AVStopAudioSample (U8BIT path)
	Stops playback of an audio sample. More...
void	STB_AVSetSpdifMode (U8BIT path, E_STB_DIGITAL_AUDIO_TYPE audio_type)
	Sets the SPDIF output mode, PCM or compressed audio. More...
void	STB_AVSetHDMIAudioMode (U8BIT path, E_STB_DIGITAL_AUDIO_TYPE audio_type)
	Sets the HDMI audio output mode, PCM or compressed. More...
void	STB_AVSetAudioDelay (U8BIT path, U16BIT millisecond)
	Sets the audio delay on the given path. More...
void	STB_AVSetVideoCallback (U8BIT path, void(*callback)(S_STB_AV_VIDEO_INFO *, void *), void *user_data)
	Register callback for updated video information. More...
void	STB_AVApplyVideoTransformation (U8BIT path, S_RECTANGLE *input, S_RECTANGLE *output)
	Apply video transformation. More...
S16BIT	STB_AVGetMinPlaySpeed (U8BIT video_decoder)
	Returns minimum video play speed as a percentage. More...
S16BIT	STB_AVGetMaxPlaySpeed (U8BIT video_decoder)
	Returns maximum video play speed as a percentage. More...
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. More...
void	STB_AVSetCopyProtection (S_STB_AV_COPY_PROTECTION *copy_protection)
	Apply the specified copy protection. This function is used for CI+. More...
void	STB_AVSetUhfModulatorChannel (U8BIT chan)
	Sets the output channel of the RF Modulator. More...
U8BIT	STB_AVGetUhfModulatorChannel (void)
	Gets the current RF modulator channel. More...
U8BIT	STB_AVGetVideoFrameRate (U8BIT path)
	Returns the frame rate of the video being decoded. More...
E_STB_AV_SRM_REPLY	STB_AVApplySRM (U8BIT path, U8BIT *data, U32BIT len)
	Apply System Renewability Message (SRM) to HDCP function. More...
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)
void	STB_AVRegisterCcCallback (U8BIT path, void *context, CC_DATA_CALLBACK callback)
	Registers CC callback function. More...

Detailed Description

Header file - Function prototypes for A/V control.

Date

06/02/2001

Typedef Documentation

typedef void(* CC_DATA_CALLBACK) (U8BIT path, void *context, U8BIT *data, U16BIT data_len)

Callback function used to notify new closed caption data.

Parameters

path	Decode path from where this closed caption data comes from.
context	Context pointer that was passed to STB_AVRegisterCcCallback().
data	Pointer to the buffer holding the closed caption data.
data_len	Size of the buffer in bytes.

Returns

None.

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

void STB_AVRegisterCcCallback	(	U8BIT	path,
		void *	context,
		CC_DATA_CALLBACK	callback
	)

Registers CC callback function.

Parameters

path	Decode path to get the closed caption data from.
context	Context pointer to be forwarded to the callback calls.
callback	Pointer to closed caption data ready callback function. NULL stops closed caption data reporting.

Returns

None.

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