IFilterMapper::RegisterFilter-Methode (strmif.h)

Artikel
03/04/2024

[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.]

Hinweis Die IFilterMapper-Schnittstelle ist veraltet. Verwenden Sie stattdessen IFilterMapper2 .

Fügt der Registrierung einen Filter hinzu. der Filter kann dann aufgezählt werden.

Syntax

HRESULT RegisterFilter(
  [in] CLSID   clsid,
  [in] LPCWSTR Name,
  [in] DWORD   dwMerit
);

Parameter

[in] clsid

GuiD (Globally Unique Identifier) des Filters.

[in] Name

Beschreibender Name für den Filter.

[in] dwMerit

Position in der Reihenfolge der Enumeration. Filter mit höherem Wert werden zuerst aufgelistet.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Hinweise

Der Wert (wie durch den dwMerit-Parameter definiert) steuert die Reihenfolge, in der der Filtergraph-Manager filtert, wenn ein Vorgang als Ergebnis eines Aufrufs von IGraphBuilder::Connect, IGraphBuilder::Render oder IGraphBuilder::RenderFile ausgeführt wird. Der Filterdiagramm-Manager findet alle Filter, die mit dem richtigen Medientyp registriert sind, und versucht dann den Filter mit dem höchsten Wert, wobei andere Kriterien in der Registrierung verwendet werden, um zwischen Filtern mit gleichem Verdienst zu wählen.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Weitere Informationen

Fehler- und Erfolgscodes

IFilterMapper-Schnittstelle

Freigeben über