ADTF  3.18.2
IActiveRunnerabstract

The Interface defines an Active Runner Intem which can be part of the IFilterGraph. More...

Inheritance diagram for IActiveRunner:
[legend]

Public Member Functions

 ADTF_IID (IActiveRunner, "active_runner.spider.streaming.adtf.iid")
 Definition of the interface identifier.
 
virtual tResult WaitForDeactivation ()=0
 This function ensures that the runner is no longer processing a trigger and is not going to emit any further trigger calls. More...
 
- Public Member Functions inherited from IActiveRunner
 ADTF_IID (IActiveRunner, "active_runner.ant.streaming.adtf.iid")
 Definition of the interface identifier.
 
 UCOM_RESOLVE (adtf::ucom::ant::IObject, INamedGraphObject)
 
virtual tResult Activate ()=0
 The Activate call is to create the Timer or Thread or other running internals of the Runner. More...
 
virtual tResult Deactivate ()=0
 The Deactivate call is to stop and destroy the Timer or Thread or other running internals of the Runner. More...
 
virtual bool IsActivated () const =0
 Return the Activatation State of the Runner. More...
 
- Public Member Functions inherited from ITriggerPipeSource
 ADTF_IID (ITriggerPipeSource, "trigger_pipe_source.ant.streaming.adtf.iid")
 definiton of interface id
 
virtual tResult RegisterSubItem (const adtf::ucom::ant::iobject_ptr< ITriggerPipeItem > &pSubRun, tPriority ui32Prio)=0
 Registers the pSubRun as SubItem of the source. More...
 
virtual tResult UnregisterSubItem (const adtf::ucom::ant::iobject_ptr< ITriggerPipeItem > &pSubRun)=0
 Unregisters the pSubRun from the source. More...
 
virtual tResult ChangePriority (const adtf::ucom::ant::iobject_ptr< ITriggerPipeItem > &pSubRun, tPriority ui32Prio)=0
 Changes the priority of the pSubRun. More...
 
virtual tResult GetSubItems (adtf::ucom::ant::iobject_enum< const ITriggerPipeItem > &lstSubItems) const =0
 Retrieves a list of the registered Items. More...
 
- Public Member Functions inherited from IObject
 ADTF_IID (IObject, "object.ant.ucom.adtf.iid")
 Marks the IObject to be castable with the ucom_cast() More...
 
- Public Member Functions inherited from INamedGraphObject
 ADTF_IID (INamedGraphObject, "namedgraphobject.ant.streaming.adtf.iid")
 defintion of interface id
 
virtual tResult GetName (base::ant::IString &&strName) const =0
 Gets the Name of the object to the IString rvalue reference strName. More...
 
virtual tResult SetName (const char *strName)=0
 Sets the Name of the object. More...
 
virtual tResult SetParent (const ucom::ant::IObject *oParentObject)=0
 Sets the Parent of the object. More...
 
virtual tResult GetParent (const ucom::ant::IObject *&poParentObject) const =0
 Retrieves the Parent of the object. More...
 

Additional Inherited Members

- Public Types inherited from ITriggerPipeSource
enum  tPriority : uint32_t {
  Invalid = 0 , Lowest = 1 , Lower = 30 , BelowNormal = 40 ,
  Normal = 50 , AboveNormal = 60 , Higher = 70 , Highest = 100
}
 Priority used for the order of ITriggerPipeItem::Run calls. More...
 
- Protected Member Functions inherited from IActiveRunner
virtual ~IActiveRunner ()=default
 is not destructable
 
- Protected Member Functions inherited from ITriggerPipeSource
 ~ITriggerPipeSource ()=default
 not destructable
 
- Protected Member Functions inherited from IObject
 ~IObject ()=default
 Protected destructor --> Use implemented Destroy() instead of delete!
 
- Protected Member Functions inherited from INamedGraphObject
 ~INamedGraphObject ()=default
 not destructable
 

Detailed Description

The Interface defines an Active Runner Intem which can be part of the IFilterGraph.

An Active Runner is able to create an Run call on registered ITriggerPipeItem.

The IActiveRunner is a special part of the IFilterGraph. The IFilterGraph will activate the IActiveRunner only AFTER every single IFilter are already in IFilter::tFilterState::State_Running !

See also
IRunner, ITriggerPipeItem

Definition at line 83 of file runner_intf.h.

Member Function Documentation

◆ WaitForDeactivation()

virtual tResult WaitForDeactivation ( )
pure virtual

This function ensures that the runner is no longer processing a trigger and is not going to emit any further trigger calls.

Returns
Standard result code.