Interaction Channel Streaming functions required by MHEG5 engine References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.1, March 2009.
More...
|
| E_MhegErr | DVB_MhegStreamSetup (U8BIT *pmt, S_ICSKeys *keys, E_ICSStatus *status) |
| | This function tells the external application that an IC delivered stream is to be played using DVB_MhegHandleStreamData. If the PAT and PMT are available before the internal ICS buffer becomes full, the PMT is provided by this function. Otherwise, the MHEG-5 engine passes NULL. The function also provides optional encryption keys for the stream. The controlling application may return immediately with status MHEG5_ICS_STATUS_READY, indicating that streaming can start. If this cannot be done synchronously, the controlling application may return the status MHEG5_ICS_STATUS_PENDING, and when the setup process is complete, DVB_MhegNotifyICSReady should be called. More...
|
| |
| E_MhegErr | DVB_MhegStreamSetComponents (S_ICSComponents *components) |
| | Set A/V components from IC delivered stream. This function can be called at any time (even while IC delivered stream is playing). Transition should be smooth, for example, if only the audio component is stopped, the video component should continue playing without glitches. If a video component is active, the termination attribute must be applied to the last frame. More...
|
| |
| U32BIT | DVB_MhegStreamHandleData (U8BIT *data, U32BIT len, BOOLEAN last) |
| | Handle transport stream data. The data is part of a single-program transport stream, containing audio, video and/or subtitles (in one or more languages). The video is H.264 SD video and the audio is HE-AAC audio. The stream contains PAT and PMT (other SI data can be ignored). This function can block until the data has been processed / buffered. It may also return when part of the block has been processed. This would cause a subsequent call with the rest of the block. When the last block is presented (last=TRUE), the function should indicate that the block has been completely processed only when this is a true reflection of the presentation status. More...
|
| |
| E_MhegErr | DVB_MhegStreamPause (void) |
| | Pause presentation of audio and/or video components of the currently playing IC delivered stream. Following this call, the video (if any) should be frozen and audio muted. Unused data delivered by DVB_MhegHandleStreamData may be returned to the MHEG-5 engine (using the return value). More...
|
| |
| E_MhegErr | DVB_MhegStreamResume (void) |
| | Resume presentation of audio and/or video components of the currently playing IC delivered stream. This function may be called by the MHEG-5 engine after DVB_MhegPauseICS (alternatively, DVB_MhegStopICS may be called). Following this call, available data is once again delivered through DVB_MhegHandleStreamData. More...
|
| |
| E_MhegErr | DVB_MhegStreamAudioSetVolume (S32BIT volumeAdjust) |
| | Set volume for audio component of the currently playing IC stream This function is equivalent to DVB_MhegAudioSetVolume. More...
|
| |
| E_MhegErr | DVB_MhegStreamStop (void) |
| | This function tells the external application that the IC delivered stream is stopped. Presentation of all stream components (audio, video and/or subtitles) should cease. This function may be called while DVB_MhegHandleStreamData is in progress. In this case DVB_MhegHandleStreamData should return indicating that the entire block has been processed. More...
|
| |
| E_MhegErr | DVB_MhegPromptForGuidance (U8BIT *restriction, BOOLEAN show) |
| | This function asks the external application to obtain permission from the user to present IP-delivered content. The external application may use the "restriction" string to tell the user why access to the content is restricted. How permission is obtained is receiver specific. More...
|
| |
| E_MhegErr | DVB_MhegGetPINSupport (E_ICSPinSupport *support) |
| | Returns the PIN support in the receiver. This MUST be a non-blocking function, returning results immediately. More...
|
| |
Interaction Channel Streaming functions required by MHEG5 engine References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.1, March 2009.
- Date
- 20/12/2012
- Author
- Adam Sturtridge
This function tells the external application that an IC delivered stream is to be played using DVB_MhegHandleStreamData. If the PAT and PMT are available before the internal ICS buffer becomes full, the PMT is provided by this function. Otherwise, the MHEG-5 engine passes NULL. The function also provides optional encryption keys for the stream. The controlling application may return immediately with status MHEG5_ICS_STATUS_READY, indicating that streaming can start. If this cannot be done synchronously, the controlling application may return the status MHEG5_ICS_STATUS_PENDING, and when the setup process is complete, DVB_MhegNotifyICSReady should be called.
- Parameters
-
| pmt | Program Map Table for IP service (or NULL) |
| keys | Information about encryption keys (or NULL) |
| status | IP streaming status (ready / pending) |
- Returns
- The following return values are allowed from this function: MHERR_OK - Success MHERR_OTHER - Controlling application specific error
1.8.6 
