ADTF
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
IReferenceClockabstract

The IReferenceClock interface provides the reference time source for the filter graph. More...

#include <reference_clock_intf.h>

Inheritance diagram for IReferenceClock:
[legend]

Classes

class  IClock
 Interface for clocks. More...
 
class  ISync2RefChannel
 Interface for synchronizing external timestamps to stream time. More...
 
struct  tReferenceClockEvent
 This structure describes the functionality for the IEventSource Communication Expansion. More...
 

Public Member Functions

 ADTF_IID (IReferenceClock, "reference_clock.flash.streaming.adtf.iid")
 Marks the IReferenceClock to be castable with the ucom_cast.
 
virtual base::flash::tNanoSeconds GetTimeNs () const =0
 
virtual base::flash::tNanoSeconds GetStreamTimeNs () const =0
 
virtual tResult GetSync2RefChannel (adtf::ucom::ant::iobject_ptr< ISync2RefChannel > &pSync2RefChannel, const char *strName=nullptr, const char *strMethod=nullptr) const =0
 Returns a new instance of a Sync2Ref Channel implementation.
 
virtual tResult GetSync2RefChannel (adtf::ucom::ant::iobject_ptr< ISync2RefChannel > &pSync2RefChannel, const char *strName=nullptr, const char *strMethod=nullptr) const=0
 Returns a new instance of a Sync2Ref Channel implementation.
 
- Public Member Functions inherited from IReferenceClock
 ADTF_IID (IReferenceClock, "reference_clock.ant.streaming.adtf.iid")
 Marks the IReferenceClock to be castable with the ucom_cast.
 
virtual tTimeStamp GetTime () const =0
 Retrieves the current reference time.
 
virtual tTimeStamp GetStreamTime () const =0
 Retrieves the stream time which is reset at the start of the stream.
 
virtual tResult RegisterClock (const adtf::ucom::ant::iobject_ptr< IClock > &pClock)=0
 Registers a new clock.
 
virtual tResult UnregisterClock (const adtf::ucom::ant::iobject_ptr< IClock > &pClock)=0
 Unregisters a clock.
 
virtual tResult GetClocks (IClockListCallback &oCallback) const =0
 Lists all available clocks.
 
virtual tResult GetClock (const char *strName, adtf::ucom::ant::iobject_ptr< IClock > &pClock) const =0
 Find a clock.
 
virtual tResult SetMainClock (const char *strName)=0
 This will change the main clock to the given clock.
 
virtual tResult GetMainClock (adtf::base::ant::IString &&strName) const =0
 Retrieves the name of the current main clock.
 
virtual tResult SetStreamClock (const char *strName)=0
 Sets the clock of which the time is returned by GetStreamTime.
 
virtual tResult GetStreamClock (adtf::base::ant::IString &&strName) const =0
 Retrieves the name of the current stream clock.
 
virtual tResult RegisterSync2RefFactory (const adtf::ucom::ant::iobject_ptr< ISync2RefChannelFactory > &oSync2RefFactory)=0
 Registers a new Sync2Ref channel factory.
 
virtual tResult UnregisterSync2RefFactory (const adtf::ucom::ant::iobject_ptr< ISync2RefChannelFactory > &oSync2RefFactory)=0
 Unregisters a Sync2Ref channel factory.
 
virtual tResult ListSync2RefMethods (ISync2RefListCallback &oCallback)=0
 Lists all available Sync2Ref methods.
 
- Public Member Functions inherited from IObject
 ADTF_IID (IObject, "object.ant.ucom.adtf.iid")
 Marks the IObject to be castable with the ucom_cast()
 

Protected Member Functions

 ~IReferenceClock ()=default
 not destructable
 
- Protected Member Functions inherited from IReferenceClock
 ~IReferenceClock ()=default
 not destructable
 
- Protected Member Functions inherited from IObject
 ~IObject ()=default
 Protected destructor --> Only the final implementation can be destroyed!
 

Additional Inherited Members

- Public Types inherited from IReferenceClock
enum  tReferenceClockEventId { EVENT_TimeResetBegin = 0x0000 , EVENT_TimeResetEnd = 0x0001 , EVENT_TimeUpdate = 0x0004 }
 Event Id enumeration for the nEventId. More...
 
- Static Public Attributes inherited from IReferenceClock
static const int ADTF_MAX_CLOCK_NAME_LENGTH = 256
 The maximum length of clock names, due to length restrictions when storing names in the clock extension of DAT files.
 

Detailed Description

The IReferenceClock interface provides the reference time source for the filter graph.

See also Clock Concept for further information on timings within ADTF. Default implementation of provide service is reached by CID_ADTF_REFERENCE_CLOCK.

Definition at line 363 of file reference_clock_intf.h.

Member Function Documentation

◆ ADTF_IID()

ADTF_IID ( IReferenceClock ,
"reference_clock.flash.streaming.adtf.iid"  )

Marks the IReferenceClock to be castable with the ucom_cast.

See also
ADTF_IID(_interface, _striid)

◆ GetSync2RefChannel() [1/2]

virtual tResult GetSync2RefChannel ( adtf::ucom::ant::iobject_ptr< ISync2RefChannel > & pSync2RefChannel,
const char * strName = nullptr,
const char * strMethod = nullptr ) const
pure virtual

Returns a new instance of a Sync2Ref Channel implementation.

Parameters
[out]pSync2RefChannelThe pointer to the new instance.
[in]strNameAn optional name of the channel (for logging purposes, need not be unique)
[in]strMethodIf given this method will be used, otherwise the set default.
Return values
ERR_NOT_FOUNDThere is no such Sync2Ref method available
Deprecated
Use GetSync2RefChannel(adtf::ucom::ant::iobject_ptr<ISync2RefChannel>& pSync2RefChannel, const char* strName = nullptr, const char* strMethod = nullptr) instead.

Implemented in IReferenceClock, IReferenceClock, IReferenceClock, IReferenceClock, and IReferenceClock.

References GetSync2RefChannel().

Referenced by ADTF_IID(), ConvertTimeOffset(), and GetSync2RefChannel().

◆ GetSync2RefChannel() [2/2]

virtual tResult GetSync2RefChannel ( adtf::ucom::ant::iobject_ptr< ISync2RefChannel > & pSync2RefChannel,
const char * strName = nullptr,
const char * strMethod = nullptr ) const
virtual

Returns a new instance of a Sync2Ref Channel implementation.

Parameters
[out]pSync2RefChannelThe pointer to the new instance.
[in]strNameAn optional name of the channel (for logging purposes, need not be unique)
[in]strMethodIf given this method will be used, otherwise the set default.
Return values
ERR_NOT_FOUNDThere is no such Sync2Ref method available
Deprecated
Use GetSync2RefChannel(adtf::ucom::ant::iobject_ptr<ISync2RefChannel>& pSync2RefChannel, const char* strName = nullptr, const char* strMethod = nullptr) instead.

Implements IReferenceClock.

Reimplemented in IReferenceClock, IReferenceClock, IReferenceClock, IReferenceClock, and IReferenceClock.