Fujitsu DTV/STB solution driver (FAPex driver) Documentation [VLR]


PVR_RecordOpenT Struct Reference

Parameters for opening a recording engine instance. More...


Data Fields

PVR_VersionEnumT version
char_t fileName [PVR_FILE_NAME_LENGTH+1]
uint8_t threadPriority
uint8_t tsdBlockIndex
uint8_t overwrite
uint32_t bufferAddress
uint32_t bufferSize
uint32_t maxSize
uint8_t enableLooping
uint32_t fillingLimit
PVR_RecordCallback callback
uint32_t tag
char_t name [PVR_NAME_LENGTH+1]
uint16_t pcrPid
uint8_t numberOfTracks
uint16_t trackPid [PVR_MAX_TRACKS]
PVR_TrackTypeT trackType [PVR_MAX_TRACKS]
uint8_t trackFormat [PVR_MAX_TRACKS]
uint32_t trackInfo [PVR_MAX_TRACKS]
uint32_t trackBufferAddress [PVR_MAX_TRACKS]
uint32_t trackBufferSize [PVR_MAX_TRACKS]
uint32_t fileSplitSize
int32_t tsdBlockFd


Detailed Description

Parameters for opening a recording engine instance.

This data structure is for passing a number of parameters to PVR_OpenRecording() when opening an instance of the recording engine.

See also:
PVR_OpenRecording()

Field Documentation

char_t PVR_RecordOpenT::fileName[PVR_FILE_NAME_LENGTH+1]

Name of file to record. The filename should not contain the path, but this depends on the underlying implementation of the file system. The maximum length is defined by PVR_FILE_NAME_LENGTH.

Priority of recording engine thread. This priority should be higher than the one for playback to ensure reliable recording. The valid range depends on the deployed operation system.

Transport stream decoder (TSD) to be used for recording. This value is limited by FAPEX_TSD_MAX.

Flag to enable overwriting of an existing file.

Base address of the buffer manager's (BM) hardware buffer 31. This buffer will be used to store the multiplexed transport stream before writing it to the hard-disk.

Note:
Global offset of corresponding buffer manager is subtracted internally.

Size of the hardware buffer (channel 31). Size of the buffer manager's (BM) hardware buffer 31. This buffer will be used to store the multiplexed transport stream before writing it to the hard-disk. It should be big enough to buffer several data chunks. A size of at least 0x80000 is recommended.

Maximum recording size in data chunks. If the file size reaches this limit the recording engine will either stop or loop to the beginning of the file (circular recording). The size of one data chunk is defined by PVR_CHUNK_SIZE.

Flag to enable circular recording. Circular recording is particularly useful for implementing time-shift functionality. For enabling circular recording a size limit has to be set additionally.

Buffer filling limit for notification. If the buffer filling exceeds this limit the notification function will be called. For example, this could be used to take action to reduce the system load and. If the system load is that high that the recording engine thread is not processed, this limit will not be monitored.

Note:
Checking the buffer filling is not enabled when at least one PID is recorded as PES!
See also:
PVR_RecordNotifyT

Pointer to callback function.

Initial tag. It is possible to set another tag during recording, for example to set a user defined marker in the stream. During playback it is possible to seek to a specified tag.

char_t PVR_RecordOpenT::name[PVR_NAME_LENGTH+1]

Initial name. It is possible to assign another name tag during recording, for example when the service name changes. The maximum length is defined in PVR_NAME_LENGTH.

PCR PID. The PCR PID is only used for creating the PMT, i.e. for recording with enabled swapBytes (and without PES). If no PCR shall be assigned set this PID to 0x1FFF.

Number of tracks (PES streams) to record. The maximum number of tracks is defined by PVR_MAX_TRACKS.

uint16_t PVR_RecordOpenT::trackPid[PVR_MAX_TRACKS]

PID of each track (PES stream) to record.

Type of each track (PES stream) to record.

uint8_t PVR_RecordOpenT::trackFormat[PVR_MAX_TRACKS]

Type-specific stream format of each track, one of PVR_TRACK_FORMAT_XXX.

uint32_t PVR_RecordOpenT::trackInfo[PVR_MAX_TRACKS]

Any additional information about each track. It is not relevant for the playback engine. It could be used as the language code for audio tracks.

uint32_t PVR_RecordOpenT::trackBufferAddress[PVR_MAX_TRACKS]

Buffer address (optional).

If this PID shall be recorded as PES data (e.g. descrambled data) an extra buffer must be assigned. The transport stream decoder will be configured so that it extracts the PID's PES data into the assigned buffer. The recording engine will then (re-)make transport stream packets out of the PES data and multiplex them to a transport stream for recording. Note that no adaption field will be added, i.e. PCR information will be removed.

Set the buffer address and size to 0 if this PID shall decoded as transport stream packets (should be preferred -> better performance).

If at least one PID is recorded as PES the TS bytes will be swapped and arranged in the correct order (see swapBytes of this structure).

uint32_t PVR_RecordOpenT::trackBufferSize[PVR_MAX_TRACKS]

Buffer size (optional).

See also:
trackBufferAddress

Maximum split file size in units of PVR_CHUNK_SIZE bytes.

The library can store a recording in multiple files. This function defines the default maximum size of one file. If the size of a file reaches this limit, the recording engine will close the file and proceed the recording in another file.

In case of FAT32 with a maximum file size of 4GB (minus one byte) this value will be 44620. The value of 0 will disable file splitting (default setting).

Note:
File splitting is not possible for circular recordings (i.e. enableLooping == 1).

TSD block file descriptor the Record driver used.


The documentation for this struct was generated from the following file:


Copyright © 2006-2010 by Fujitsu Microelectronics Europe GmbH
Copyright © 2008-2010 by Fujitsu Microelectronics Limited

Disclaimer:
Please note that the use of this has been based on the terms and conditions of "DK Consent Letter (For Linux)" agreement between you and Fujitsu Microelectronics Limited.
The contents of this document may be revised without prior notice. Contact our sales department for confirmation. The information in this document are presented as is, no license is granted by implication or otherwise.
More...

FUJITSU sales representatives