dvb_pvr.h

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

// @param u32NextFileHandle	(Input)Next file handle for record
//
// @return TRUE or FALSE
// @retval TRUE	Set next file handle success
// @retval FALSE 	Set next file handle failed
//
// @description 
//        	This function is called to next file handle according to current file handle
//*********************************************************************************
bool8 DVB_PVR_SetNextRecordFileHandle(u32 u32FileHandle, u32 u32NextFileHandle);

//*********************************************************************************
// @summary       Set current sector size
//
// @param u32Size	(Input)The size of one sector
//
// @return TRUE or FALSE
// @retval TRUE	Set sector size success
// @retval FALSE 	Set sector size failed
//
// @description 
//        	This function is called to change current sector size
//*********************************************************************************
bool8 DVB_PVR_SetSectorSize(u32 u32Size);

//*********************************************************************************
// @summary       Set current to time shift mode or not
//
// @param b8Mode	(Input)Whether set to time shift mode or not
//
// @return void
//
// @description 
//        	This function is called to set to time shift mode or not
//*********************************************************************************
void DVB_PVR_SetTimeShitMode(bool8 b8Mode);

//*********************************************************************************
// @summary       Set none-AV PID
//
// @param pstNotAvPid	(Input)The structure include all none-AV PID
//
// @return TRUE or FALSE
// @retval TRUE	Set none-AV PID success
// @retval FALSE 	Set none-AV PID failed
//
// @description 
//        	This function is called to set none-AV PID
//*********************************************************************************
bool8 DVB_PVR_SetNotAvPid(ST_PVR_NOT_AV_PID *pstNotAvPid);

//*********************************************************************************
// @summary       Set current playback status to slow forward play
//
// @param enSpeed	(Input)The speed of slow forward
//
// @return TRUE or FALSE
// @retval TRUE	Set slow forward play success
// @retval FALSE 	Set slow forward play failed
//
// @description 
//        	This function is called to set to slow forward play mode
//*********************************************************************************
bool8 DVB_PVR_SlowForwardPlay(EN_PVR_PLAYBACK_SPEED enSpeed);

//*********************************************************************************
// @summary       Set to live backward in time shift
//
// @param enSpeed	(Input)The speed of live backward
// @param u16LiveVid	(Input)The video pid of live
// @param u16LiveAid	(Input)The audio pid of live
//
// @return TRUE or FALSE
// @retval TRUE	Set live backward play success
// @retval FALSE 	Set live backward play failed
//
// @description 
//        	This function is called to set to live backward in time shift
//*********************************************************************************
bool8 DVB_PVR_TimeShiftLiveBackward(EN_PVR_PLAYBACK_SPEED enSpeed,u16 u16LiveVid, u16 u16LiveAid);

//*********************************************************************************
// @summary       Set read position to write position
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Set read to write success
// @retval FALSE 	Set read to write failed
//
// @description 
//        	This function is called to set read position to write position
//*********************************************************************************
bool8 DVB_PVR_TimeShiftSetReadToWrite(void);

//*********************************************************************************
// @summary       Set current status to preview
//
// @param pstScanPreviewParam	(Input)Provide the parameter for preview
// @param u16LiveVid				(Input)Provide the live video pid for preview
// @param u16LiveAid				(Input)Provide the live audio pid for preview
//
// @return TRUE or FALSE
// @retval TRUE	Set to preview mode success
// @retval FALSE 	Set to preview mode failed
//
// @description 
//        	This function is called to set current mode to preview mode
//*********************************************************************************
bool8 DVB_PVR_ScanPreview(ST_PVR_PLAY_PARAMETER *pstScanPreviewParam, u16 u16LiveVid, u16 u16LiveAid);

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

//*********************************************************************************
// @summary      	Get current speed of playing
//
// @param void
//
// @return Playback speed
// @retval EN_PVR_SPEED_X2	Current play speed is 2X speed
// @retval EN_PVR_SPEED_X4 	Current play speed is 4X speed
// @retval EN_PVR_SPEED_X8 	Current play speed is 4X speed
// @retval EN_PVR_SPEED_X16 	Current play speed is 4X speed
// @retval EN_PVR_SPEED_X32 	Current play speed is 4X speed
// @retval EN_PVR_SPEED_NORMAL Current play speed is normal
//
// @description 
//        	This function is called to get current play speed
//*********************************************************************************
EN_PVR_PLAYBACK_SPEED DVB_PVR_Play_GetSpeed(void);

//*********************************************************************************
// @summary      	Get current play mode
//
// @param void
//
// @return Play mode
// @retval EN_PVR_PLAY_NORMAL	Current play mode is normal play
// @retval EN_PVR_PLAY_FORWARD 	Current play mode is forward play
// @retval EN_PVR_PLAY_SLOWFORWARD 	Current play mode is slow forward play
// @retval EN_PVR_PLAY_BACKWARD	Current play mode is backward play
//
// @description 
//        	This function is called to get current play mode
//*********************************************************************************
EN_PVR_PLAYMODE DVB_PVR_Play_GetMode(void);

//*********************************************************************************
// @summary      	Get current stream rate
//
// @param void
//
// @return Current stream rate
// @retval u32 StreamRate with sector/s
//
// @description 
//        	This function is called to get stream rate
//*********************************************************************************
u32 DVB_PVR_GetCurStreamRate(void);

//*********************************************************************************
// @summary      	Send callback event
//
// @param EN_PVR_EVENT	(Input)Callback event
//
// @return TRUE or FALSE
// @retval TRUE	Send callback event success
// @retval FALSE	Send callback event failed
//
// @description 
//        	This function is called to send a callback event
//*********************************************************************************
bool8 _dvb_pvr_send_cb_event(EN_PVR_EVENT enEvent);

//*********************************************************************************
// @summary      	Get current recording duration
//
// @param void
//
// @return current duration
// @retval u32	The tick count from start to record
//
// @description 
//        	This function is called to get current recording duration
//*********************************************************************************
u32 DVB_PVR_GetCurrentRecordingDuration(void);

//*********************************************************************************
// @summary      	Get last recording duration
//
// @param void
//
// @return last duration
// @retval u32	The tick count of last recording duration
//
// @description 
//        	This function is called to get last recording duration
//*********************************************************************************
u32 DVB_PVR_GetLastRecordingDuration(void);

//*********************************************************************************
// @summary      	Unpause a paused status
//
// @param void
//
// @return TRUE or FALSE
// @retval TRUE	Unpause success
// @retval FALSE	Unpause failed
//
// @description 
//        	This function is called to unpause a paused status
//*********************************************************************************
bool8 DVB_PVR_UnPause(void);

//*********************************************************************************
// @summary      	Get a file handle which is removed by time shift
//
// @param void
//
// @return Removed file handle
// @retval u32	The handle of removed file	
//
// @description 
//        	This function is called to get the removed handle of time shift
//*********************************************************************************
u32 DVB_PVR_GetTimeshiftRemovedFileHandle(void);

//*********************************************************************************
// @summary      	Get current sector size
//
// @param void
//
// @return Sector size
// @retval u32	Current sector size	
//
// @description 
//        	This function is called to get current sector size
//*********************************************************************************
u32 DVB_PVR_GetSectorSize(void);

//*********************************************************************************
// @summary      	Get the video PID of live
//
// @param void
//
// @return Live video PID
// @retval u32	Live video PID
//
// @description 
//        	This function is called to get live video PID
//*********************************************************************************
u32 DVB_PVR_GetLiveVideoPid(void);

//*********************************************************************************
// @summary      	Get the audio PID of live
//
// @param void
//
// @return Live audio PID
// @retval u32	Live audio PID
//
// @description 
//        	This function is called to get live audio PID
//*********************************************************************************
u32 DVB_PVR_GetLiveAudioPid(void);

//*********************************************************************************
// @summary      	Get the parameters of time shift 
//
// @param pu32ReadHandleIndex	(Input)Read handle index
// @param pu32WriteHandleIndex	(Input)Write handle index
// @param pu32ReadPosition		(Input)Read position
// @param pu32WritePosition		(Input)Write position
//
// @return void
//
// @description 
//        	This function is called to get time shift's parameters
//*********************************************************************************
void DVB_PVR_GetTimeShiftParams(u32* pu32ReadHandleIndex, u32* pu32WriteHandleIndex, 
	u32* pu32ReadPosition, u32* pu32WritePosition);

//*********************************************************************************
// @summary      	Get the max file size
//
// @param void
//
// @return Max file size
// @retval u32	The max file size
//
// @description 
//        	This function is called to get maxmum file size
//*********************************************************************************
u32 DVB_PVR_GetMaxFileSize(void);

//*********************************************************************************
// @summary       Get timeshift current read and write position
//
// @param pstPosition	(Output)timeshift position
//
// @return void
//
// @description 
//        	This function is called to get the timeshift read and write position
//*********************************************************************************
void DVB_PVR_GetTimeShift_Position(ST_TIME_SHIFT_POS *pstPosition);
//==========================For Test AP PVR Structure===================================

typedef struct
{
	u16 u16Vid;
	u16 u16Aid;
	u8	u8AudioFreq;
}ST_AP_PVR_TS_HEADER;

#endif