Microsoft DirectX 8.0

IRegFilterInfo Interface

Provides access to filters in the Windows® Registry, and adds registered filters to the filter graph.

The filter graph manager implements this interface for use by applications written in Microsoft® Visual Basic®. C/C++ applications should use the IFilterMapper2 interface instead.

The IMediaControl::get_RegFilterCollection method returns a collection of IRegFilterInfo interfaces. Use the interface to query the names of filters in the collection and add desired filters to the filter graph.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Returns pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IDispatch methodsDescription
GetTypeInfoCount Determines whether there is type information available for this dispinterface.
GetTypeInfo Retrieves the type information for this dispinterface if GetTypeInfoCount returned successfully.
GetIDsOfNames Converts text names of properties and methods (including arguments) to their corresponding DISPIDs.
InvokeCalls a method or accesses a property in this dispinterface if given a DISPID and any other necessary parameters.
IRegFilterInfo methodsDescription
get_Name Retrieves the name of the filter.
Filter Creates an instance of this filter and adds it to the filter graph.

IRegFilterInfo::Filter

IRegFilterInfo Interface

Creates an instance of this filter and adds it to the filter graph.

Syntax

HRESULT Filter(

  IDispatch **ppUnk
  );

Parameters

ppUnk
[out] Address of a pointer to the IFilterInfo interface for the added filter.

Return Value

Returns an HRESULT value.

Remarks

Use the IRegFilterInfo::get_Name method (Name property in Visual Basic) to find the filter by comparing names in a collection of IRegFilterInfo interfaces.

IRegFilterInfo::get_Name

IRegFilterInfo Interface

Retrieves the name of the filter.

Syntax

HRESULT get_Name(

  BSTR *strName
  );

Parameters

strName
[out, retval] Pointer to the name of the filter.

Return Value

Returns an HRESULT value.

Remarks

Typically, a Visual Basic application will use the For Each...Next syntax on a collection of IRegFilterInfo interfaces and check the name of each filter in the registry until it finds the one it wants to add. It can then add the filter to the filter graph by using the IRegFilterInfo::Filter method.