Class TRtpEvent

class TRtpEvent;

Description

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.

Members

Defined in TRtpEvent:

• IsReceiveSourceEvent()constTests whether this event is associated with a receive stream.
• IsSendSourceEvent()constTests whether this event is associated with a send stream.
• IsSessionEvent()constTests whether this event is associated with an RTP session.
• ReceiveSource()constGets a handle to the receive stream associated with this event.
• SendSource()constGets a handle to the send stream associated with this event.
• Session()constGets a handle to the session associated with this event.
• Status()constGets the event status.
• TRtpEvent(TRtpEventType,TInt,TAny *)Constructor.
• Type()constGets the type of this event.

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

Description

Constructor.

Parameters

IMPORT_C RRtpSession Session() const;

Description

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.

Return value

Panic codes

See also:

• TRtpEvent::IsSessionEvent()constTests whether this event is associated with an RTP session.

IMPORT_C RRtpSendSource SendSource() const;

Description

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.

Return value

Panic codes

See also:

• TRtpEvent::IsSendSourceEvent()constTests whether this event is associated with a send stream.

IMPORT_C RRtpReceiveSource ReceiveSource() const;

Description

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.

Return value

Panic codes

See also:

• TRtpEvent::IsReceiveSourceEvent()constTests whether this event is associated with a receive stream.

IMPORT_C TBool IsSessionEvent() const;

Description

Tests whether this event is associated with an RTP session.

Return value

IMPORT_C TBool IsSendSourceEvent() const;

Description

Tests whether this event is associated with a send stream.

Return value

IMPORT_C TBool IsReceiveSourceEvent() const;

Description

Tests whether this event is associated with a receive stream.

Return value

inline TRtpEventType Type() const;

Description

Gets the type of this event.

Return value

inline TInt Status() const;

Description

Gets the event status.

The meaning of this depends on the event type.

Return value