ADTF: IDynamicDataBinding

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_NOERROR	in pin was created and registered. `pInPin` must be set to a valid pin reference.
any_error	Depending 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
	)