NVIDIA Iray API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
mi::rtmp::IPause_event_handler Class Referenceabstract

Superclass of all handlers of pause events. More...

Inheritance diagram for mi::rtmp::IPause_event_handler:
Inheritance graph
[legend]

Public Member Functions

virtual bool  handle (bool is_pause, IStream *stream)=0
  Called on a pause or resume event. More...
 

Additional Inherited Members

- Public Types inherited from mi::base::Interface_declare< 0x5e4f3910, 0x3f00, 0x4e80, 0xa9, 0x77, 0x98, 0x15, 0x6d, 0xa0, 0x92, 0x8b >
typedef Interface_declare< id1,
id2, id3, id4, id5, id6, id7,
id8, id9, id10, id11,
IInterface
Self
  Own type. More...
 
typedef Uuid_t< id1, id2, id3,
id4, id5, id6, id7, id8, id9,
id10, id11 > 
IID
  Declares the interface ID (IID) of this interface. More...
 
- Static Public Member Functions inherited from mi::base::Interface_declare< 0x5e4f3910, 0x3f00, 0x4e80, 0xa9, 0x77, 0x98, 0x15, 0x6d, 0xa0, 0x92, 0x8b >
static bool  compare_iid (const Uuid &iid)
  Compares the interface ID iid against the interface ID of this interface and of its ancestors. More...
 

Detailed Description

Superclass of all handlers of pause events.

A subclass gets registered via mi::rtmp::IStream::register_pause_event_handler() and will be called in the case of a pause event which can be either pause or resume.

Member Function Documentation

virtual bool mi::rtmp::IPause_event_handler::handle ( bool  is_pause,
IStream stream 
)
pure virtual

Called on a pause or resume event.

The event handler allows to filter pause or resume events. If it returns true the render loop for the corresponding stream is affected as follows. If is_pause is true the render event handler will not be called anymore. If is_pause is false the render event handler will again be called as often as indicated by the maximum render rate for the stream. If the pause event handler returns false nothing changes.

Pause/resume events are similar to play/stop events but are less expensive w.r.t. the internal state of the RTMP server.

Note
The stream parameter is only valid during the call of the handle() method and cannot be stored (even if proper reference counting is used).
Parameters
is_pause true indicates a pause event, false indicates a resume event.
stream The stream on which to pause or resume playing.
Returns
true if the event should be honored, or false if should be ignored.