ADTF  3.18.2
IDynamicInterfaceBindingabstract

This interface extends the IInterfaceBinding Interface to provide dynamic binding object creation while connection are established within Streaming Graph and Filter Graph. More...

Public Member Functions

 ADTF_IID (IDynamicInterfaceBinding, "dynamic_interface_binding.ant.streaming.adtf.iid")
 defintion of interface id
 
virtual tResult RequestBindingObject (const char *strName, const ucom::ant::iobject_ptr< const IBindingType > &pType, ucom::ant::iobject_ptr< IBindingClient > &pBindingClient)=0
 Request a client binding object which can not be find via IInterfaceBinding::FindBindingObject. More...
 
virtual tResult RequestBindingObject (const char *strName, const ucom::ant::iobject_ptr< const IBindingType > &pType, ucom::ant::iobject_ptr< IBindingServer > &pBindingServer)=0
 Request a server binding object which can not be find via IInterfaceBinding::FindBindingObject. More...
 

Protected Member Functions

 ~IDynamicInterfaceBinding ()=default
 not destructable
 

Detailed Description

This interface extends the IInterfaceBinding Interface to provide dynamic binding object creation while connection are established within Streaming Graph and Filter Graph.

Definition at line 88 of file interface_binding_intf.h.

Member Function Documentation

◆ RequestBindingObject() [1/2]

virtual tResult RequestBindingObject ( const char *  strName,
const ucom::ant::iobject_ptr< const IBindingType > &  pType,
ucom::ant::iobject_ptr< IBindingClient > &  pBindingClient 
)
pure virtual

Request a client binding object which can not be find via IInterfaceBinding::FindBindingObject.

This function will be used to create and retrieve a client binding object which is requested by an added connection. While connection are established within the Filter Graph or the Streaming Graph and the Filter does not provide a the requested binding object this call will be used to request the client binding object.

Parameters
strName[in] client object name requested
pType[in] binding type of the Binding Proxy.
pBindingClient[in, out] Set to a valid client binding object if created one. On Error the caller do not care.
Return values
ERR_NOERRORclient binding object was created and registered. pBindingClient must be set to a valid binding object reference.
any_errorDepending on the implementation. If any error occures the Streaming Graph and Filter Graph will stop initializing.

◆ RequestBindingObject() [2/2]

virtual tResult RequestBindingObject ( const char *  strName,
const ucom::ant::iobject_ptr< const IBindingType > &  pType,
ucom::ant::iobject_ptr< IBindingServer > &  pBindingServer 
)
pure virtual

Request a server binding object which can not be find via IInterfaceBinding::FindBindingObject.

This function will be used to create and retrieve a server binding object which is requested by an added connection. While connection are established within the Filter Graph or the Streaming Graph and the Filter does not provide a the requested binding object this call will be used to request the server binding object.

Parameters
strName[in] client object name requested
pType[in] binding type of the Binding Proxy.
pBindingServer[in, out] Set to a valid server binding object if created one. On Error the caller do not care.
Return values
ERR_NOERRORserver binding object was created and registered. pBindingServer must be set to a valid binding object reference.
any_errorDepending on the implementation. If any error occures the Streaming Graph and Filter Graph will stop initializing.