DigiGuide External Structures

Only ANSI is currently supported, UNICODE support will be added in the future.

DGE_PROGRAMME

The DGE_PROGRAMME structure represents a programme. Note that from build 230 of version 6.0 it also supports a DGE_MARKER structure that allows access to some useful marker values.

typedef struct tagDGE_MARKER
{
	UINT uMarkerType;
	UINT uMarkerID;
} DGE_MARKER, FAR * LPDGE_MARKER;


typedef struct tagDGE_PROGRAMMEA
{
	GM_uint32 uStructSize;
	SYSTEMTIME stTimeStart;
	GM_uint32 uMinutesDuration;
	LPCSTR pcszName;
	LPCSTR pcszCategory;
	LPCSTR pcszDescription;
	LPCSTR pcszChannelName;
	LPCSTR pcszChannelAssignment;

	//
	//	These were added in Beta 5.0 build 167
	GM_uint32 uReminderID;
	GM_uint32 uSmartSearchID;
	GM_uint32 uFavouriteID;

	//
	//	These were added in Beta 6.0 build 230
	LPDGE_MARKER	lpMarkerArray;
	GM_uint32 uMarkerCount;

	//
	//	These added for extra importing flexibility in Beta 8.3 Build 1081
	GM_uint32 uYear;
	GM_uint32 uRating;				//	0 - 5
	LPCSTR  pcszCertificate;
	LPCSTR  pcszKeywords;			//	Comma seperated list
	LPCSTR  pcszActors;				//	Comma seperated list
	LPCSTR  pcszDirectors;			//	Comma seperated list
	LPCSTR  pcszEpisode;
	LPCSTR  pcszSubTitle;

	LPCSTR  pcszLanguageCode;	//	Language that description is written in, can be empty (english)

	LPCSTR  pcszQualifier1;		//	Comma seperated list
	LPCSTR  pcszQualifier2;		//	Comma seperated list
	LPCSTR  pcszQualifier3;		//	Comma seperated list

	GM_uint32 uLineNumber;						//	Line number used for error reporting

	//
	//	This added for extra importing flexibility.
	LPCTSTR  pcszCountryOfOrigin;	//	Country which created programme, can be empty

} DGE_PROGRAMME, FAR * LPDGE_PROGRAMME;

Members

uiStructSize: Specifies the size of the structure in bytes.
stTimeStart: Specifies the start time of the programme.
uiMinutesDuration: Specifies the duration of the programme in minutes.
pcszName: Specifies the name of the programme.
pcszCategory: Specifies the category of the programme.
pcszDescription: Specifies the description of the programme.
pcszChannelName: Specifies the name of the channel the programme is on.
pcszChannelAssignment: Specifies the assignment for the channel the programme is on.
uReminderID: DigiGuide's ID for a reminder. Zero if this programme is not marked with a reminder.
uSmartSearchID: DigiGuide's ID for a Smart Search. Zero if this programme is not marked with a Smart Search.
uFavouriteID: DigiGuide's ID for a favourite. Zero if this programme is not marked with a favourite.
lpMarkerArray: If the programme is marked in some way then this will point to an array of DGE_MARKER structures. If it's not marked then this will be null.
uMarkerCount: The number of DGE_MARKER structures pointed by lpMarkerArray.

Notes

uReminderID, uSmartSearchID and uFavouriteID were added in build 167 of DigiGuide beta 5.0

lpMarkerArray and uMarkerCount uFavouriteID were added in build 230 of DigiGuide beta 6.0