Skip to content

Latest commit

 

History

History
100 lines (59 loc) · 3.09 KB

amoviesetupregisterfilter2.md

File metadata and controls

100 lines (59 loc) · 3.09 KB
description ms.assetid title ms.topic ms.date topic_type api_name api_type api_location ms.custom
The AMovieSetupRegisterFilter2 function registers a filter's merit, pins, and media types in the registry using the IFilterMapper2 interface.
8e0f3485-9e5d-4b22-853d-4ad9b1fb71d2
AMovieSetupRegisterFilter2 function (Dllsetup.h)
reference
4/26/2023
APIRef
kbSyntax
AMovieDllRegisterServer
LibDef
Strmbase.lib
Strmbase.dll
Strmbasd.lib
Strmbasd.dll
UpdateFrequency5

AMovieSetupRegisterFilter2 function

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The AMovieSetupRegisterFilter2 function registers a filter's merit, pins, and media types in the registry using the IFilterMapper2 interface.

Syntax

HRESULT AMovieDllRegisterServer(
   const AMOVIESETUP_FILTER const * psetupdata,
         IFilterMapper2             *pIFM2,
         BOOL                       bRegister
);

Parameters

psetupdata

Pointer to the AMOVIESETUP_FILTER data.

pIFM2

Pointer to IFilterMapper2 interface.

bRegister

Value indicating whether to register the filter; TRUE indicates register the filter, FALSE indicates unregister it.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The AMovieDllRegisterServer2 function calls this helper function to register a filter after the COM server has been registered.

Typically, a filter will use AMovieDllRegisterServer2 and will not call this function directly.

Requirements

Requirement Value
Header
Dllsetup.h (include Streams.h)
Library
Strmbase.lib (retail builds);
Strmbasd.lib (debug builds)

See also

DLL Setup Functions