MHEG5 PVR functions for New Zealand or Australia profile References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.1, August 2009. [2] MHEG Profile for New Zealand, version 1.0.3, August 2008 [3] MHEG-5 Profile for Australia, V0.0.1, May 2009.
More...
#include "techtype.h"
#include "dtvstring.h"
#include "mherrors.h"
Go to the source code of this file.
|
| E_MhegErr | PVR_MakeBooking (S_STRING crid, S_CRID_DETAILS *details) |
| | The function adds an event to the PVR’s list of scheduled events to record. The type of CRID can be any of a single programme or series. The type is defined in crid_type to aid the PVR in finding the required CID. Where the CRID is a series CRID the booking relates to all programme events that are part of the series. The PVR is required to validate the CRID and check that resources are available for the booking. This may involve searching for multiple instances of an event until one is found that does not clash with a previous booking. Where no such instance is found the PVR may choose to indicate the conflict to the viewer, giving them the option to cancel one or more of the bookings. Each 'booking' in 'details' has a logical 'OR' between them. So receiver should choose one booking. The PVR must be able to record all 'locations' for the booking to be successful. The platform implementation of this funtion should only return MHERR_CONFLICT when it does not ask the user, via the native GUI, for input regarding conflicts. If it does ask for user input, then it should return MHEG5_RESULT_PENDING, and subsequently call MHG_NotifyBookingResult() More...
|
| |
| E_MhegErr | PVR_CancelBooking (S_STRING crid, U16BIT crid_type) |
| | Removes an event from the PVR schedule. More...
|
| |
| S_CRID_REC * | PVR_ListBookings (U16BIT *number) |
| | Returns an array of CRIDs (and CRID types for NZ profile) that are being monitored by the PVR. More...
|
| |
| void | PVR_ReleaseList (S_CRID_REC *crid_array) |
| | MHEG indicates that it is finished using the array returned by PVR_ListBookings(). For example, platforms that malloc memory for this, may wish to free the memory here. More...
|
| |
| S_CRID_DETAILS * | PVR_GetDetails (S_STRING crid) |
| | Required by Australia profile only. Returns the type, name, description and a single booking section only containing location details required to resolve the booking. More...
|
| |
| void | PVR_ReleaseDetails (S_CRID_DETAILS *details) |
| | Required by Australia profile only. MHEG indicates that it is finished using the CRID details returned by PVR_GetDetails(). For platforms that malloc memory for this, it is a chance to free the memory. More...
|
| |
MHEG5 PVR functions for New Zealand or Australia profile References: [1] UK1 Profile - Digital Terrestrial Television - Requirements for interoperability (The D-Book), Issue 6.1, August 2009. [2] MHEG Profile for New Zealand, version 1.0.3, August 2008 [3] MHEG-5 Profile for Australia, V0.0.1, May 2009.
- Date
- 20/12/2012
- Author
- Adam Sturtridge
Removes an event from the PVR schedule.
- Parameters
-
| crid | Content Reference Identifier string |
- Returns
- MHERR_OK - Success, booking removed MHERR_FILE_NOT_FOUND - Booking not found MHERR_OTHER - removal failed for other reason
Required by Australia profile only. Returns the type, name, description and a single booking section only containing location details required to resolve the booking.
- Parameters
-
| crid | Content Reference Identifier string |
- Returns
- Pointer to S_CRID_DETAILS, if success NULL, if CRID not found
Returns an array of CRIDs (and CRID types for NZ profile) that are being monitored by the PVR.
- Parameters
-
| number | Number of Content References in array |
- Returns
- Pointer to array of S_CRID_REC, or NULL if there are no bookings
The function adds an event to the PVR’s list of scheduled events to record. The type of CRID can be any of a single programme or series. The type is defined in crid_type to aid the PVR in finding the required CID. Where the CRID is a series CRID the booking relates to all programme events that are part of the series. The PVR is required to validate the CRID and check that resources are available for the booking. This may involve searching for multiple instances of an event until one is found that does not clash with a previous booking. Where no such instance is found the PVR may choose to indicate the conflict to the viewer, giving them the option to cancel one or more of the bookings. Each 'booking' in 'details' has a logical 'OR' between them. So receiver should choose one booking. The PVR must be able to record all 'locations' for the booking to be successful. The platform implementation of this funtion should only return MHERR_CONFLICT when it does not ask the user, via the native GUI, for input regarding conflicts. If it does ask for user input, then it should return MHEG5_RESULT_PENDING, and subsequently call MHG_NotifyBookingResult()
- Parameters
-
| crid | Content Reference Identifier string |
| details | Pointer to structure with description of Content Reference |
- Returns
- MHERR_OK - Success, MHERR_CONFLICT - conflict with a previous booking MHEG5_IGNOR_REQUEST - booking cancelled by user MHEG5_INSUFFICIENT_SPACE - booking failed due to insufficient space MHERR_OVERBOOKED - booking failed due to too many bookings MHERR_OTHER - booking failed for other reason MHEG5_RESULT_PENDING - result pending, and will mean a subsequent call to MHG_NotifyBookingResult()
Required by Australia profile only. MHEG indicates that it is finished using the CRID details returned by PVR_GetDetails(). For platforms that malloc memory for this, it is a chance to free the memory.
- Parameters
-
| details | Pointer of Content Reference details structure |
- Returns
- void
MHEG indicates that it is finished using the array returned by PVR_ListBookings(). For example, platforms that malloc memory for this, may wish to free the memory here.
- Parameters
-
| crid_array | Array of Content Reference Identifier's |
- Returns
- void
1.8.6 
