glue_queue.c File Reference

MHEG5 Queue. More...

#include "techtype.h"
#include "stb_os.h"
#include "glue_memory.h"
#include "glue_debug.h"
#include "glue_queue.h"

Go to the source code of this file.

Classes
struct	s_msg_queue
struct	s_q_notify

Macros
#define	UP_MSGS_WHEN_Q_FULL
#define	Q_STATS(s)
#define	CRITICAL_Q_SIZE   (1 << 3)
#define	HIGH_Q_SIZE   (1 << 3)
#define	NORMAL_Q_SIZE   (1 << 8)
#define	LOW_Q_SIZE   (1 << 4)
#define	EXCLUSION_RATIO   (35)

Typedefs
typedef struct s_msg_queue	S_MSG_QUEUE
typedef struct s_q_notify	S_Q_NOTIFY

Functions
E_MhegErr	VQ_Open (S_MhegConfig *cfg_params)
	Initialise component control and section queues. Allocates memory for, sets up and creates event (component control) and section queues. More...
void	VQ_Close (void)
	Close component control and section queue component. Destroys all allocated memory and resources for event and section queues. Must be called before MHEG5 main task starts. More...
E_MhegErr	VQ_PutMsg (S_MhegMessage *pMsg, E_PRIORITY priority)
	Post an event or section into component queues. Copies data into queue. More...
E_MhegErr	VQ_GetMsg (S_MhegMessage *pMsg)
	Get an event or section from the component queues. This is a blocking function. More...
U16BIT	VQ_GetSizeFree (E_PRIORITY priority)
	Get size available on a queue. More...
BOOLEAN	VQ_EventNeedsProcessing (void)
	Check whether any events on component queues needs processing. More...
void *	VQ_RegisterNotify (F_QueueNotify normal_rcvd, F_QueueNotify critical_rcvd, F_QueueNotify critical_done)
void	VQ_UnRegisterNotify (void *qn)

Detailed Description

MHEG5 Queue.

Date

19 October 2011

Author

Adam Sturtridge

Definition in file glue_queue.c.

Macro Definition Documentation

#define CRITICAL_Q_SIZE   (1 << 3)

Definition at line 41 of file glue_queue.c.

#define EXCLUSION_RATIO   (35)

Definition at line 48 of file glue_queue.c.

#define HIGH_Q_SIZE   (1 << 3)

Definition at line 42 of file glue_queue.c.

#define LOW_Q_SIZE   (1 << 4)

Definition at line 44 of file glue_queue.c.

#define NORMAL_Q_SIZE   (1 << 8)

Definition at line 43 of file glue_queue.c.

#define Q_STATS

(

s

)

Definition at line 39 of file glue_queue.c.

#define UP_MSGS_WHEN_Q_FULL

Definition at line 32 of file glue_queue.c.

Typedef Documentation

typedef struct s_msg_queue S_MSG_QUEUE

typedef struct s_q_notify S_Q_NOTIFY

Function Documentation

void VQ_Close

(

void

)

Close component control and section queue component. Destroys all allocated memory and resources for event and section queues. Must be called before MHEG5 main task starts.

Close component control and section queue component. Destroys all allocated memory and resources for event and section queues.

Returns

void

Definition at line 140 of file glue_queue.c.

BOOLEAN VQ_EventNeedsProcessing

(

void

)

Check whether any events on component queues needs processing.

Returns

TRUE - if processing required

Definition at line 457 of file glue_queue.c.

E_MhegErr VQ_GetMsg

(

S_MhegMessage *

pMsg

)

Get an event or section from the component queues. This is a blocking function.

Parameters

pEvent

Pointer to component event or section data structure.

Returns

MHERR_OK - Completed successfully. MHERR_COMP_NOT_OPEN - Component queues not open. MHERR_INTERNAL - System error.

Definition at line 341 of file glue_queue.c.

U16BIT VQ_GetSizeFree

(

E_PRIORITY

priority

)

Get size available on a queue.

Parameters

pEvent

Pointer to component event or section data structure.

Returns

number left in queue.

Definition at line 434 of file glue_queue.c.

E_MhegErr VQ_Open

(

S_MhegConfig *

cfg_params

)

Initialise component control and section queues. Allocates memory for, sets up and creates event (component control) and section queues.

Parameters

num_section_buffers

Maximum number of sections in queue

Returns

MHERR_OK - Completed successfully. MHERR_BAD_PARAMETER - Invalid parameter. MHERR_COMP_ALREADY_OPEN - Component queues already open. MHERR_ALLOCATING_MEMORY_REGION - Not enough memory to allocate. MHERR_INTERNAL - System error.

Definition at line 96 of file glue_queue.c.

E_MhegErr VQ_PutMsg	(	S_MhegMessage *	pMsg,
		E_PRIORITY	priority
	)

Post an event or section into component queues. Copies data into queue.

Post event or section message on queue. Copies data into queue.

Parameters

pEvent	Pointer to component event.
msg_size	data size excluding size of S_MhegMessage

Returns

MHERR_OK - Completed successfully. MHERR_BAD_PARAMETER - Invalid parameter. MHERR_COMP_NOT_OPEN - Component queues not open. MHERR_INTERNAL - System error. MHERR_ALLOCATING_MEMORY_REGION - Not enough memory to allocate. MHERR_QUEUE_FULL - Queue full.

Definition at line 248 of file glue_queue.c.

void* VQ_RegisterNotify	(	F_QueueNotify	normal_rcvd,
		F_QueueNotify	critical_rcvd,
		F_QueueNotify	critical_done
	)

Parameters

critical_rcvd	Pointer to function signalling a critical event
critical_done	Pointer to function inform critical event done

Returns

void

Definition at line 507 of file glue_queue.c.

void VQ_UnRegisterNotify

(

void *

qn

)

Parameters

normal_rcvd

Pointer to function signalling an async event

Returns

void

Definition at line 530 of file glue_queue.c.