ADTF: IDynamicInterfaceBinding

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_NOERROR	client binding object was created and registered. `pBindingClient` must be set to a valid binding object reference.
any_error	Depending 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.