IFilterMapper2::RegisterFilter-Methode (strmif.h)

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die RegisterFilter -Methode fügt der Registrierung Filterinformationen hinzu.

Syntax

HRESULT RegisterFilter(
  [in]      REFCLSID         clsidFilter,
  [in]      LPCWSTR          Name,
  [in, out] IMoniker         **ppMoniker,
  [in]      const CLSID      *pclsidCategory,
  [in]      LPCOLESTR        szInstance,
  [in]      const REGFILTER2 *prf2
);

Parameter

[in] clsidFilter

Klassenbezeichner (CLSID) des Filters.

[in] Name

Beschreibender Name für den Filter.

[in, out] ppMoniker

Adresse eines Zeigers auf einen Gerätemoniker, der bestimmt, wo die Daten dieses Filters geschrieben werden. Kann NULL sein.

[in] pclsidCategory

Zeiger auf die Filterkategorie des Filters. Bei NULL ist die Standardkategorie CLSID_ActiveMovieFilters. (Siehe Filterkategorien.)

[in] szInstance

Instanzdaten zum Erstellen des Anzeigenamens des Gerätemonikers. Dies kann der Anzeigename oder die Zeichenfolgendarstellung des Filters CLSID sein. Wenn NULL, wird standardmäßig die Filter-CLSID verwendet.

[in] prf2

Zeiger auf eine REGFILTER2-Struktur , die Filterinformationen enthält.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
VFW_E_BAD_KEY	Der Registrierungsschlüssel konnte nicht abgerufen werden.

Hinweise

Diese Methode fügt der Registrierung unter dem Registrierungseintrag für die angegebene Filterkategorie Informationen zum Filter hinzu. Der Prozessserver, der den Filter erstellt (normalerweise eine DLL), wird nicht registriert. Um den Server zu registrieren, können Sie die Funktion AMovieDllRegisterServer2 aufrufen.

Verwenden Sie für den ppMoniker-Parameter eine der folgenden Optionen:

Die Adresse eines IMoniker-Schnittstellenzeigers für einen vorhandenen Gerätemoniker
Die Adresse eines NULL-IMoniker-Schnittstellenzeigers
NULL

Wenn Sie einen Filter für ein Windows-Treibermodell (WDM) oder Plug & Play Gerät registrieren, übergeben Sie die Adresse des vorhandenen Gerätemonikers. Der Filter wird mit diesem Moniker registriert. Wenn die Methode zurückgibt, wird *ppMoniker auf NULL festgelegt.

Andernfalls erstellt die -Methode einen neuen Moniker. Wenn ppMoniker ungleich NULL ist, legt die Methode *ppMoniker fest, um auf den neuen Moniker zu verweisen. Die Anwendung kann diesen Moniker verwenden, um zusätzliche private Werte in den Eigenschaftenbehälter zu schreiben. Stellen Sie sicher, dass Sie die -Schnittstelle freigeben.

Legen Sie ppMoniker auf NULL fest, wenn Sie den Moniker nicht angeben oder empfangen möchten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IFilterMapper2-Schnittstelle

Freigeben über