ADTF  3.18.2
IADTFRuntimeabstract

Interface for accessing additional funcionality within the ADTF runtime. More...

Inheritance diagram for IADTFRuntime:
[legend]

Public Types

enum class  tADTFMicroRunLevel : int8_t {
  MRL_Shutdown = ucom::ant::IRuntime::RL_Shutdown , MRL_System = 10 , MRL_Session = 20 , MRL_StreamingGraph = 30 ,
  MRL_FilterGraphConstructed = 33 , MRL_FilterGraphInitialized = 36 , MRL_FilterGraphReady = 40 , MRL_FilterGraph = MRL_FilterGraphReady ,
  MRL_Running = 50 , MRL_Max = MRL_Running , MRL_Internal = ucom::ant::IRuntime::RL_Internal
}
 Micro Runlevels offer more fine grained control to initialization etc. More...
 
enum  tRuntimeHookId : uint32_t {
  RHI_MicroRunLevelPreIncrement = adtf::ucom::ant::IRuntime::tRuntimeHookId::RHI_RunLevelPreIncrement + 100 , RHI_MicroRunLevelPostIncrement , RHI_MicroRunLevelPreDecrement , RHI_MicroRunLevelPostDecrement ,
  RHI_MicroRunLevelIncrementing , RHI_MicroRunLevelDecrementing
}
 Additional hooks for micro runlevel changes. More...
 
enum  tServiceEvent : uint32_t { SE_ChangeMicroRunLevel = adtf::ucom::ant::IService::tServiceEvent::SE_ChangeRunLevel + 100 }
 Additional events for micro runlevel changes.
 

Public Member Functions

 ADTF_IID (IADTFRuntime, "adtf_runtime.quiet.base.adtf.iid")
 Marks the IRuntime to be castable with the ucom_cast<> More...
 
virtual tResult SetMicroRunLevel (tADTFMicroRunLevel nRunlevelToChangeTo, bool bWait=true)=0
 Request a change to the given micro runlevel. More...
 
virtual tADTFMicroRunLevel GetMicroRunLevel () const =0
 
- 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...
 

Additional Inherited Members

- Protected Member Functions inherited from IObject
 ~IObject ()=default
 Protected destructor --> Use implemented Destroy() instead of delete!
 

Detailed Description

Interface for accessing additional funcionality within the ADTF runtime.

Definition at line 22 of file adtf_runtime_intf.h.

Member Enumeration Documentation

◆ tADTFMicroRunLevel

enum tADTFMicroRunLevel : int8_t
strong

Micro Runlevels offer more fine grained control to initialization etc.

Enumerator
MRL_Shutdown 

The system is shut down.

MRL_System 

The system level.

MRL_Session 

The session level.

MRL_StreamingGraph 

The Streaminggraph level.

MRL_FilterGraphConstructed 

All graph objects are constructed.

MRL_FilterGraphInitialized 

All graph objects are initialized and ready to be connected.

MRL_FilterGraphReady 

All graph objects are connected and ready to be started.

MRL_FilterGraph 

The Filtergraph level.

MRL_Running 

The Running level.

MRL_Max 

maximum level that can be reached

Definition at line 34 of file adtf_runtime_intf.h.

◆ tRuntimeHookId

enum tRuntimeHookId : uint32_t

Additional hooks for micro runlevel changes.

Enumerator
RHI_MicroRunLevelPreIncrement 

Called before the run level is incremented.

  • IRuntimeHook::tHookInfo::ui32Param1 contains the runlevel.
RHI_MicroRunLevelPostIncrement 

Called after the run level was incremented.

  • IRuntimeHook::tHookInfo::ui32Param1 contains the runlevel.
RHI_MicroRunLevelPreDecrement 

Called before the run level is decremented.

  • IRuntimeHook::tHookInfo::ui32Param1 contains the runlevel.
RHI_MicroRunLevelPostDecrement 

Called after the run level was decremented.

  • IRuntimeHook::tHookInfo::ui32Param1 contains the runlevel.
RHI_MicroRunLevelIncrementing 

Called before the run level is incrementing.

  • IRuntimeHook::tHookInfo::ui32Param1 contains the runlevel reaching.
RHI_MicroRunLevelDecrementing 

Called while the run level is decrementing.

  • IRuntimeHook::tHookInfo::ui32Param1 contains the runlevel leaving.

Definition at line 65 of file adtf_runtime_intf.h.

Member Function Documentation

◆ ADTF_IID()

ADTF_IID ( IADTFRuntime  ,
"adtf_runtime.quiet.base.adtf.iid"   
)

Marks the IRuntime to be castable with the ucom_cast<>

See also
ADTF_IID(_interface, _striid)

◆ GetMicroRunLevel()

virtual tADTFMicroRunLevel GetMicroRunLevel ( ) const
pure virtual
Returns
The current micro runlevel.

◆ SetMicroRunLevel()

virtual tResult SetMicroRunLevel ( tADTFMicroRunLevel  nRunlevelToChangeTo,
bool  bWait = true 
)
pure virtual

Request a change to the given micro runlevel.

Parameters
[in]nRunlevelToChangeToThe runlevel that should be changed to.
[in]bWaitWhether or not to block until the requested runlevel has been reached.
Returns
Standard result.