Microsoft DirectX 8.0

IAMovieSetup Interface

Note  This interface has been deprecated. It is used by two obsolete functions, AMovieDllRegisterServer and AMovieDllUnregisterServer. These functions are now replaced by AMovieDllRegisterServer2, which does not require IAMovieSetup. However, IAMovieSetup will continue to be supported for backward compatibility with existing applications.

In Microsoft® ActiveMovie® 1.0, filters implemented self-registration as follows:

As noted, you should now use the AMovieDllRegisterServer2 function. Filters registered with this function do not need to implement IAMovieSetup. For more information, see How to Register DirectShow Filters.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IAMovieSetup methodsDescription
Register Adds the filter to the registry.
Unregister Removes the filter from the registry.

IAMovieSetup::Register

IAMovieSetup Interface

Adds the filter to the registry.

Syntax

HRESULT Register(void);

Return Value

Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.
E_FAIL Failure.
E_POINTER Null pointer argument.
E_INVALIDARG Invalid argument.
E_NOTIMPL Method isn't supported.
S_OK or NOERROR Success.

Remarks

This method registers the filter, its pins, and the media type associated with the pins. It should be implemented to use IFilterMapper methods to accomplish this. See the CBaseFilter::Register member function for a description of its implementation.

IAMovieSetup::Unregister

IAMovieSetup Interface

Removes the filter from the registry.

Syntax

HRESULT Unregister(void);

Return Value

Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.
E_FAIL Failure.
E_POINTER Null pointer argument.
E_INVALIDARG Invalid argument.
E_NOTIMPL Method isn't supported.
S_OK or NOERROR Success.

Remarks

This method should be implemented to use the IFilterMapper::UnregisterFilter method to remove the filter from the registry. This effectively removes the pins and media types as well.