ADTF  3.18.2
IDynamicDataBindingabstract

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

Inheritance diagram for IDynamicDataBinding:
[legend]

Public Member Functions

 ADTF_IID (IDynamicDataBinding, "dynamic_data_binding.ant.streaming.adtf.iid")
 defintion of interface id
 
virtual tResult RequestPin (const char *strName, const ucom::ant::iobject_ptr< const IStreamType > &pType, ucom::ant::iobject_ptr< IInPin > &pInPin)=0
 Request a in pin which can not be find via IDataBinding::FindPin. More...
 
virtual tResult RequestPin (const char *strName, const ucom::ant::iobject_ptr< const IStreamType > &pType, ucom::ant::iobject_ptr< IOutPin > &pOutPin)=0
 Request a out pin which can not be find via IDataBinding::FindPin. More...
 

Protected Member Functions

 ~IDynamicDataBinding ()=default
 not destructable
 

Detailed Description

This interface extends the IDatabinding Interface to provide dynamic pin creation while connection are established within Streaming Graph and Filter Graph.

Definition at line 64 of file data_binding_intf.h.

Member Function Documentation

◆ RequestPin() [1/2]

virtual tResult RequestPin ( const char *  strName,
const ucom::ant::iobject_ptr< const IStreamType > &  pType,
ucom::ant::iobject_ptr< IInPin > &  pInPin 
)
pure virtual

Request a in pin which can not be find via IDataBinding::FindPin.

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

Parameters
strName[in] pin name requested
pType[in] stream type of the Sample Stream if already set. Could be nullptr if stream type was not yet sent to the Sample Stream, so check content !!
pInPin[in, out] Set to a valid input pin if created one. On Error the caller do not care.
Remarks
This is the ADTF 2 Connection Pin mechanism.
Return values
ERR_NOERRORin pin was created and registered. pInPin must be set to a valid pin reference.
any_errorDepending on the implementation. If any error occures the Streaming Graph and Filter Graph will stop initializing.

◆ RequestPin() [2/2]

virtual tResult RequestPin ( const char *  strName,
const ucom::ant::iobject_ptr< const IStreamType > &  pType,
ucom::ant::iobject_ptr< IOutPin > &  pOutPin 
)
pure virtual

Request a out pin which can not be find via IDataBinding::FindPin.

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

Parameters
strName[in] pin name requested
pType[in] stream type of the Sample Stream if already set. Could be nullptr if stream type was not yet sent to the Sample Stream, so check content !!
pOutPin[in, out] Set to a valid input pin if created one. On Error the caller do not care.
Return values
ERR_NOERRORout pin was created and registered. pOutPin must be set to a valid pin reference.
any_errorDepending on the implementation. If any error occures the Streaming Graph and Filter Graph will stop initializing.