Collapse all Symbian^3 Application Developer Library

TRtpEvent Class Reference

class TRtpEvent

An RTP event.

An event is generated when anything happens that a client might want to know about. The class encapulates two pieces of information: 1. An event type as defined by a TRtpEventType value. 2. Additional information whose meaning is dependent on the event type.

Additional information may be implicitly associated with the event, but still needs to be fetched from another object, for example, when processing an ERtpPacketReceived event, the packet (represented by a RRtpReceivePacket handle) must be obtained from the receive stream (represented by a RRtpReceiveStream handle).

Events are always associated with either an RTP session, a send stream or a receive stream, and this class has functions for getting the corresponding handle.

RRtpSession RRtpSendSource RRtpReceiveSource

Public Member Functions
	TRtpEvent ( TRtpEventType , TInt , TAny *)
IMPORT_C TBool	IsReceiveSourceEvent ()
IMPORT_C TBool	IsSendSourceEvent ()
IMPORT_C TBool	IsSessionEvent ()
IMPORT_C RRtpReceiveSource	ReceiveSource ()
IMPORT_C RRtpSendSource	SendSource ()
IMPORT_C RRtpSession	Session ()
TInt	Status ()
TRtpEventType	Type ()

Private Attributes
TAny *	iData
TInt	iStatus
TRtpEventType	iType

Constructor & Destructor Documentation

TRtpEvent(TRtpEventType, TInt, TAny *)

IMPORT_C	TRtpEvent	(	TRtpEventType	aType,
			TInt	aStatus,
			TAny *	aData
		)

Constructor.

Parameters

TRtpEventType aType	The event type.
TInt aStatus	The event status.
TAny * aData	Additional data that is dependent on the event type.

Member Functions Documentation

IsReceiveSourceEvent()

IMPORT_C TBool

IsReceiveSourceEvent

(

)

const

Tests whether this event is associated with a receive stream.

IsSendSourceEvent()

IMPORT_C TBool

IsSendSourceEvent

(

)

const

Tests whether this event is associated with a send stream.

IsSessionEvent()

IMPORT_C TBool

IsSessionEvent

(

)

const

Tests whether this event is associated with an RTP session.

ReceiveSource()

IMPORT_C RRtpReceiveSource

ReceiveSource

(

)

const

Gets a handle to the receive stream associated with this event.

This function should only be called for events that are associated with a receive stream, otherwise it raises a panic.

panic: RTP 8 if the event is not associated with a receive stream. Note that this panic is raised in debug mode only; in release mode, calling this function on in inappropriate event is likely to raise panics such as KERN-EXEC 3.

TRtpEvent::IsReceiveSourceEvent()

SendSource()

IMPORT_C RRtpSendSource

SendSource

(

)

const

Gets a handle to the send stream associated with this event.

This function should only be called for events that are associated with a send stream, otherwise it raises a panic.

panic: RTP 8 if the event is not associated with a send stream. Note that this panic is raised in debug mode only; in release mode, calling this function on in inappropriate event is likely to raise panics such as KERN-EXEC 3.

TRtpEvent::IsSendSourceEvent()

Session()

IMPORT_C RRtpSession

Session

(

)

const

Gets a handle to the session associated with this event.

This function should only be called for events that are associated with an RTP session, otherwise it raises a panic.

panic: RTP 8 if the event is not associated with an RTP session. Note that this panic is raised in debug mode only; in release mode, calling this function on in inappropriate event is likely to raise panics such as KERN-EXEC 3.

TRtpEvent::IsSessionEvent()

Status()

TInt

Status

(

)

const [inline]

Gets the event status.

The meaning of this depends on the event type.

TRtpEventType

Type()

TRtpEventType

Type

(

)

const [inline]

Gets the type of this event.

Member Data Documentation

TAny * iData

TAny *

iData

[private]

TInt iStatus

TInt

iStatus

[private]

TRtpEventType iType

TRtpEventType

iType

[private]