dvb_pvr.h

DVB软件,基于CT216软件的开发源程序.

u32 DVB_PVR_GetCurRecHandle(void);

//*********************************************************************************
// @summary       Get current device type  
//
// @param void
//
// @return Device type
// @retval EN_NO_DEVICE	There's not any device 
// @retval EN_CARDREADER_DEVICE Current device is card reader
// @retval EN_USB_DEVICE Current device is USB
//
// @description 
//        This function is called to get current PVR device.
//*********************************************************************************
EN_DEVICE_TYPE DVB_PVR_GetDevice(void);

//*********************************************************************************
// @summary       Get current play percent 
//
// @param void
//
// @return Play percent
// @retval u16	Current play percent 
//
// @description 
//        This function is called to get current play percent when playing record file
//*********************************************************************************
u16 DVB_PVR_GetPlayPercent(void);

//*********************************************************************************
// @summary       Get current playback time
//
// @param void
//
// @return Playback time from start playing
// @retval u32	Seconds from start playing
//
// @description 
//        This function is called to get play time from start
//*********************************************************************************
u32 DVB_PVR_GetPlaybackTime(void);

//*********************************************************************************
// @summary       Get current play status
//
// @param void
//
// @return Play status
// @retval EN_PVR_PLAY_NONE	Current play status is none
// @retval EN_PVR_PLAY_FILE	Current play status is playing file
// @retval EN_PVR_TIME_SHIFT	Current play status is time shift
// @retval EN_PVR_ERROR_PLAY Current play status is error
//
// @description 
//        This function is called to get current play status
//*********************************************************************************
EN_PVR_PLAY_STATUS DVB_PVR_GetPlayStatus(void);

//*********************************************************************************
// @summary       Get current preview status
//
// @param void
//
// @return Preview status
// @retval TRUE	Kernel is in preview status
// @retval FALSE	Kernel is not in previewe status
//
// @description 
//        This function is called to get current preview status
//*********************************************************************************
bool8 DVB_PVR_GetPreviewStatus(void);

//*********************************************************************************
// @summary       Get current record status
//
// @param void
//
// @return record status
// @retval EN_PVR_RECORD_NONE	Current record status is none
// @retval EN_PVR_RECORD_FILE	Current play status is recording file
//
// @description 
//        This function is called to get current record status
//*********************************************************************************
EN_PVR_RECORD_STATUS DVB_PVR_GetRecordStatus(void);

//*********************************************************************************
// @summary       Set current play status to normal play
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Set to normal play success
// @retval FALSE	Set to normal play failed
//
// @description 
//        	This function is called to set current play mode to normal play
//*********************************************************************************
bool8 DVB_PVR_NormalPlay(void);

//*********************************************************************************
// @summary       Set current play status to pause
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Set to playback pause success
// @retval FALSE	Set to playback pause failed
//
// @description 
//        	This function is called to set current play mode to pause
//*********************************************************************************
bool8 DVB_PVR_PlaybackPause(void);

//*********************************************************************************
// @summary       Start to record
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Start recording success
// @retval FALSE	Start recording failed
//
// @description 
//        	This function is called to start to record
//*********************************************************************************
bool8 DVB_PVR_PlaybackRecordingStart(u16 u16LiveVid, u16 u16LiveAid);

//*********************************************************************************
// @summary       Stop recording
//
// @param u16LiveVid	(Input) Live video pid
// @param u16LiveAid	(Input) Live audio pid
//
// @return TRUE or FALSE
// @retval TRUE	Stop recording success
// @retval FALSE	Stop recording failed
//
// @description 
//        	This function is called to stop recording
//*********************************************************************************
bool8 DVB_PVR_PlaybackRecordingStop(void);

//*********************************************************************************
// @summary       Set playback to skip mode
//
// @param s32Second	(Input) Seconds to skip
//
// @return TRUE or FALSE
// @retval TRUE	Set skip mode success
// @retval FALSE	Set skip mode failed
//
// @description 
//        	This function is called to skip some seconds when playback
//*********************************************************************************
bool8 DVB_PVR_PlaybackSkip(s32 s32Second);

//*********************************************************************************
// @summary       Set playback to jump mode
//
// @param pstJumpParam)	(Input) File index and offset position
//
// @return jump status
// @retval EN_JUMP_OK	Set jump mode success
// @retval EN_JUMP_ERROR	Set jump mode failed
// @retval EN_JUMP_LIVE	Jump to live state
//
// @description 
//        	This function is called to jump offset position when playback
//*********************************************************************************
EN_PVR_JUMP_STATUS DVB_PVR_PlaybackJump(ST_PVR_JUMP_PARAMETER *pstJumpParam);

//*********************************************************************************
// @summary       Start playback
//
// @param pstPlaybackParam	(Input) Playback parameter for starting playback
// @param u16LiveVid			(Input) Live video pid for starting playback
// @param u16LiveAid			(Input) Live audio pid for starting playback
//
// @return TRUE or FALSE
// @retval TRUE	Start playing success
// @retval FALSE	Start playing failed
//
// @description 
//        	This function is called to start playback.
//*********************************************************************************
bool8 DVB_PVR_PlaybackStart(ST_PVR_PLAY_PARAMETER *pstPlaybackParam, u16 u16LiveVid, u16 u16LiveAid);

//*********************************************************************************
// @summary       Stop playback
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Stop playing success
// @retval FALSE	Stop playing failed
//
// @description 
//        	This function is called to stop playback.
//*********************************************************************************
bool8 DVB_PVR_PlaybackStop(void);

//*********************************************************************************
// @summary       Add PID of PVR
//
// @param u16Pid	PID which is needed by PVR
//
// @return TRUE or FALSE
// @retval TRUE	Set PID success
// @retval FALSE	Set PID failed
//
// @description 
//        	This function is called to add PID for PVR
//*********************************************************************************
bool8 DVB_PVR_RecordAddPid(u16 u16Pid);

//*********************************************************************************
// @summary       Start recording
//
// @param pstRecordParam	(Input)Recording parameter when starting record
//
// @return TRUE or FALSE
// @retval TRUE	Start recording success
// @retval FALSE	Start recording failed
//
// @description 
//        	This function is called to start recording
//*********************************************************************************
bool8 DVB_PVR_RecordStart(ST_PVR_RECORD_PARAMETER *pstRecordParam);

//*********************************************************************************
// @summary       Stop recording
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Stop recording success
// @retval FALSE	Stop recording failed
//
// @description 
//        	This function is called to stop recording
//*********************************************************************************
bool8 DVB_PVR_RecordStop(void);

//*********************************************************************************
// @summary       Register a notify function 
//
// @param fpNotify	(Input)Notify function of callback
//
// @return TRUE or FALSE
// @retval TRUE	Register notify function success
// @retval FALSE	Register notify function failed
//
// @description 
//        	This function is called to register notify function
//*********************************************************************************
bool8 DVB_PVR_Register(DVB_PVR_NOTIFY_FN fpNotify);

//*********************************************************************************
// @summary       Set audio/video PID
//
// @param pstAvPid	(Input)Audio/Video PID struct pointer
//
// @return TRUE or FALSE
// @retval TRUE	Set audio/video PID success
// @retval FALSE	Set audio/video PID failed
//
// @description 
//        	This function is called to set audio/video PID
//*********************************************************************************
bool8 DVB_PVR_SetAvPid(ST_PVR_AV_PID *pstAvPid);

//*********************************************************************************
// @summary       Set current device
//
// @param enDevice	(Input)Device type which will be set
//
// @return Device type
// @retval EN_NO_DEVICE	There's not any device 
// @retval EN_CARDREADER_DEVICE Card reader device
// @retval EN_USB_DEVICE USB device
//
// @description 
//        	This function is called to set current device type
//*********************************************************************************
bool8 DVB_PVR_SetDevice(EN_DEVICE_TYPE enDevice);

//*********************************************************************************
// @summary       Set parser audio/video PID
//
// @param u16Vid	(Input)Video PID
// @param u16Aid (Input)Audio PID
//
// @return TRUE or FALSE
// @retval TRUE	Set parser audio/video PID success
// @retval FALSE 	Set parser audio/video PID failed
//
// @description 
//        	This function is called to set audio/video PID for parser using
//*********************************************************************************
bool8 DVB_PVR_SetParserAVPid(u16 u16Vid,u16 u16Aid);

//*********************************************************************************
// @summary       Set record time
//
// @param u32Second	(Input)Record seconds
//
// @return TRUE or FALSE
// @retval TRUE	Set record time success
// @retval FALSE 	Set record time failed
//
// @description 
//        	This function is called to set record time
//*********************************************************************************
bool8 DVB_PVR_SetRecordTime(u32 u32Second);

//*********************************************************************************
// @summary       Get record live past time
//
// @param ST_DVB_TIME *(output)
//
// @return u32 current recording live time
//
// @description 
//        	This function is called to get record live past time
//*********************************************************************************
u32 DVB_PVR_GetRecDuration(void);

//*********************************************************************************
// @summary       Set next file handle
//
// @param u32FileHandle	(Input)Current file handle for record