IGraphConfig::AddFilterToCache-Methode (strmif.h)

[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 AddFilterToCache -Methode fügt dem Filtercache einen Filter hinzu.

Syntax

HRESULT AddFilterToCache(
  [in] IBaseFilter *pFilter
);

Parameter

[in] pFilter

Zeiger auf die IBaseFilter-Schnittstelle des Filters.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	Beschreibung
E_FAIL	Fehler.
E_POINTER	NULL-Zeigerargument.
S_FALSE	Der Filter befindet sich bereits im Cache.
S_OK	Filter wurde dem Cache hinzugefügt.

Hinweise

Sie müssen alle Pins des Filters trennen, bevor Sie diese Methode aufrufen, andernfalls schlägt die Methode fehl. Wenn sich der Filter im Filterdiagramm befindet, wird er von dieser Methode entfernt. Diese Methode versetzt den Filter auch in einen beendeten Zustand, wenn er noch nicht vorhanden ist.

Anforderungen

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

Weitere Informationen

Fehler- und Erfolgscodes

IGraphConfig-Schnittstelle