IMediaFilter::Run-Methode (strmif.h)

  • Artikel

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

Die Run -Methode führt den Filter aus.

Syntax

HRESULT Run(
  REFERENCE_TIME tStart
);

Parameter

tStart

Referenzzeit, die der Streamzeit 0 entspricht.

Rückgabewert

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

Rückgabecode Beschreibung
S_FALSE
 Der Übergang ist nicht abgeschlossen.
S_OK
 Erfolg. Der Übergang ist abgeschlossen.

Hinweise

Wenn ein Filter ausgeführt wird, kann er Beispiele empfangen, verarbeiten und übermitteln. Quellfilter generieren neue Beispiele, und Rendererfilter rendern sie.

Der Zustandsübergang kann asynchron sein. Wenn die Methode vor Abschluss des Übergangs zurückgibt, wird der Rückgabewert S_FALSE.

Stream Zeit wird als aktuelle Referenzzeit abzüglich tStart berechnet. Um zu berechnen, wann ein Medienbeispiel gerendert werden soll, vergleicht der Renderer den Zeitstempel mit der aktuellen Streamzeit. Daher sollte ein Medienbeispiel mit einem Zeitstempel von null zum Zeitpunkt tStart gerendert werden. Weitere Informationen finden Sie unter Zeit und Uhren in DirectShow.

Wenn eine Anwendung die IMediaControl::Run-Methode aufruft, ruft IMediaFilter::Run der Filter Graph Manager für jeden Filter auf. Er legt den Wert von tStart in zukunft geringfügig fest, um die Graphlatenz zu berücksichtigen.

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

IMediaFilter-Schnittstelle