IMVFilterPropertyControl

The IMVFilterPropertyControl Interface from the  MV FilterPropertyControl  contains some methods to display property pages from DirectShow filter in a tab control.

Methods:

Typelib: MVFilterPropertyControl

Method IMVFilterPropertyControl::Activate

Declaration: Sub Activate

Activate the current property page and updates his data.

Prototype:

HRESULT Activate();

Method IMVFilterPropertyControl::Apply

Declaration: Sub Apply(AllPages As Boolean)

Applies change from the current/all property pages.

Parameter:

AllPages

If TRUE all property pages saves there data into the corresponding DirectShow filter. If FALSE only the current page saves his data.

Prototype:

HRESULT Apply(BOOL AllPages);

Property IMVFilterPropertyControl::CurrentPage

Declaration: Property Get/Put CurrentPage As Long

Contains the current filter property page index.

Prototype:

HRESULT put_CurrentPage(LONG Page);
HRESULT get_CurrentPage(LONG* Page);

Property IMVFilterPropertyControl::Enabled

Declaration: Property Get/Put Enabled As Boolean

Enable the control.

Prototype:

HRESULT put_Enabled(BOOL Enable);
HRESULT get_Enabled(BOOL* Enable);

Method IMVFilterPropertyControl::GetMaxSize

Declaration: Sub GetMaxSize(Filter As String, Control As Unknown, Pages As Long, Width As Long, Height As Long)

Get the max size for the property pages.

Parameter:

	Filter	Filter label within the filter graph configuration .
	Control	Interface from the MV Smart Control with the filter graph configuration.
	Pages	Page mask, see below .
	Width	Returns the width for the control.
	Height	Returns the height for the control.

The Pages parameter allows to select specific property pages from a filter. It is a bit mask. If a bit is set the control displays the corresponding property page

Example: Page = 5; The control shows the first (bit 0) and the third (bit 2) property page.

Prototype:

HRESULT GetMaxSize(BSTR Filter, IUnknown* Control, LONG Pages, LONG* Width, LONG* Height);

Method IMVFilterPropertyControl::Init

Declaration: Sub Init(Filter As String, Control As Unknown, Pages As Long)

Initialises the control with the property pages from a filter.

Parameter:

	Filter	Filter label within the filter graph configuration.
	Control	Interface from the MV Smart Control with the filter graph configuration.
	Pages	Page mask, see below.

The Pages parameter allows to select specific property pages from a filter. It is a bit mask. If a bit is set the control displays the corresponding property page.

Example: Page = 5; The control shows the first (bit 0) and the third (bit 2) property page.

Prototype:

HRESULT Init(BSTR Filter, IUnknown* Control, LONG Pages);

Metho IMVFilterPropertyControl::ReleasePages

Declaration: Sub ReleasePages()

Release all resources. Call this method before unloadung a filter configuration.

Prototype:

HRESULT ReleasePages();