IMediaDet::p ut_Filter-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Hinweis

[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]

 

Die put_Filter -Methode gibt einen Quellfilter an, der vom Mediendetektor verwendet werden soll.

Wichtig

Fügen Sie den Quellfilter nicht Ihrem eigenen Filterdiagramm hinzu, oder verwenden Sie einen Filter, der sich bereits in einem Filterdiagramm befindet. Das Mediendetektorobjekt erstellt automatisch ein internes Filterdiagramm, und das Einfügen des Filters in ein anderes Diagramm kann zu unerwarteten Ergebnissen führen.

 

Syntax

HRESULT put_Filter(
  [in] IUnknown *newVal
);

Parameter

newVal [in]

Zeiger auf die IUnknown-Schnittstelle des Quellfilters.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_NOINTERFACE	newVal zeigt nicht auf einen Filter.
E_POINTER	NULL-Zeigerargument.

 

Bemerkungen

Für die meisten Anwendungen ist es einfacher, die IMediaDet::p ut_Filename-Methode mit dem Namen einer Quelldatei aufzurufen.

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.

 

Hinweis

Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

 

Anforderungen

Anforderung	Wert
Header	Qedit.h
Bibliothek	Strmiids.lib

Siehe auch

IMediaDet-Schnittstelle

Fehler- und Erfolgscodes